Skip to main content

Get-CloudPCCustomImage

Returns Windows 365 Cloud PC custom device images.

Description

Calls the Microsoft Graph beta https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages endpoint and returns custom OS images uploaded for Cloud PC provisioning.

Syntax


Get-CloudPCCustomImage [[-Id] <string>] [[-DisplayName] <string>] [[-Status] <string>] [<CommonParameters>]

Parameters

NameTypeRequiredAliasesDescription
DisplayNameStringNoNameOptional exact display name filter. Alias: Name.
IdStringNoOptional exact custom image ID filter.
StatusStringNoOptional image status filter.

Output

Id : 00000000-0000-0000-0000-000000000000
DisplayName : Win11-Corp-Image
OperatingSystem : Windows 11 Enterprise
OsBuildNumber : 23H2
OsVersionNumber : 10.0.22631.3593
Version : 1.0.0
Status : ready
OsStatus : supported
SizeGB : 64
SourceImageResourceId : /subscriptions/.../resourceGroups/rg/providers/Microsoft.Compute/images/win11-corp

Graph endpoints

/beta/deviceManagement/virtualEndpoint/deviceImages

Example 1

Get-CloudPCCustomImage | Format-Table DisplayName,Status,OperatingSystem,OsBuildNumber

Example 2

Get-CloudPCCustomImage -DisplayName 'Win11-Corp-Image'

Example 3

Get-CloudPCCustomImage -Status ready

Source

View Get-CloudPCCustomImage.ps1 on GitHub