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