命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示云电脑上的图像资源。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | cloudPcDeviceImage 集合 | 列出 cloudPcDeviceImage 对象的属性和关系。 |
| Get | cloudPcDeviceImage | 读取 cloudPcDeviceImage 对象的属性和关系。 |
| 创建 | cloudPcDeviceImage | 创建新的 cloudPcDeviceImage 对象。 |
| 删除 | 无 | 删除 cloudPcDeviceImage 对象。 |
| 获取源图像 | cloudPcSourceDeviceImage 集合 | 获取 cloudPcSourceDeviceImage 对象。 |
| 重新上传 | 无 | 重新加载无法上传的 cloudPcDeviceImage 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 关联设备映像的显示名称。 设备映像显示名称和版本用于唯一标识云电脑设备映像。 只读。 |
| errorCode | cloudPcDeviceImageErrorCode | 图像状态的错误代码，指示上传失败的原因（如果适用）。 可能的值为：internalServerError、、sourceImageNotFoundosVersionNotSupported、unknownFutureValuevmAlreadyAzureAdJoinedpaidSourceImageNotSupportsourceImageInvalidsourceImageNotGeneralizedsourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation、sourceImageWithDataDiskNotSupported、sourceImageWithDiskEncryptionSetNotSupported、 。 sourceImageWithAzureDiskEncryptionNotSupported
Prefer: include-unknown-enum-members使用请求标头从此可演变枚举中获取以下值：vmAlreadyAzureAdJoined、、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitationsourceImageWithDataDiskNotSupported、sourceImageWithDiskEncryptionSetNotSupported、 sourceImageWithAzureDiskEncryptionNotSupported。 只读。 |
| expirationDate | 日期 | 映像不可用的日期。 只读。 |
| id | String | 云电脑上映像资源的唯一标识符 (ID) 。 只读。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改图像的数据和时间。 时间戳使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 |
| operatingSystem | String | 映像的作系统。 例如，Windows 11 Enterprise。 只读。 |
| osBuildNumber | String | 映像的 OS 内部版本。 例如，1909。 只读。 |
| osStatus | cloudPcDeviceImageOsStatus | 此映像的 OS 状态。 可能的值包括 supported、supportedWithWarning、unknown、unknownFutureValue。 默认值为 unknown。 只读。 |
| osVersionNumber | String | 此映像的作系统版本。 例如，10.0.22000.296。 只读。 |
| sizeInGB | Int32 | 映像的大小（以 GB 为单位）。 例如，64。 只读。 |
| sourceImageResourceId | String | Azure上源图像资源的唯一标识符 (ID) 。 所需的 ID 格式为：“/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}”。 只读。 |
| status | cloudPcDeviceImageStatus | 云电脑上映像的状态。 可能的值包括 pending、ready、warning、failed、unknownFutureValue。 只读。 |
| version | String | 映像版本。 例如， 0.0.1 和 1.5.13。 只读。 |
| statusDetails (已弃用) | cloudPcDeviceImageStatusDetails | 图像状态的详细信息，指示上传失败的原因（如果适用）。 可取值为：internalServerError、sourceImageNotFound、osVersionNotSupported、sourceImageInvalid、sourceImageNotGeneralized、unknownFutureValue、vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。
Prefer: include-unknown-enum-members使用请求标头从此可演变枚举中获取以下值：vmAlreadyAzureAdJoined、paidSourceImageNotSupport、、sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 只读。
statusDetails 属性已弃用，将于 2024 年 1 月 31 日停止返回数据。 今后，请使用 errorCode 属性。 |
cloudPcDeviceImageErrorCode 值
| 成员 | 说明 |
|---|---|
| internalServerError | 处理图像期间发生内部服务器错误。 |
| sourceImageNotFound | 源图像不可访问或找不到。 |
| osVersionNotSupported | 不支持 OS 版本。 |
| sourceImageInvalid | 源映像对于预配 Windows 虚拟机 (VM) 无效。 |
| sourceImageNotGeneralized | 上传的图像不会通用化。 运行 sysprep/generalize 命令后重新上传映像。 若要了解详细信息，请参阅 在创建映像之前通过取消预配或通用化 VM 来删除特定于计算机的信息。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| vmAlreadyAzureAdJoined | 已将生成用于创建设备映像的源映像的 VM 联接到Microsoft Entra。 这可以防止验证过程允许使用此类源映像创建设备映像。 |
| paidSourceImageNotSupport | 此源映像是从Azure市场的另一个付费映像生成的，不受支持;请使用其他源继续。 |
| sourceImageNotSupportCustomizeVMName | 生成的通用化映像上存在计算机名称设置问题，这阻止使用提供的映像自定义 VM 名称。 |
| sourceImageSizeExceedsLimitation | 客户上传的源映像的大小超出了共享映像库 (SIG) 限制，从而导致映像创建失败。 |
| sourceImageWithDataDiskNotSupported | 指示源映像附加了关联的数据磁盘的错误代码。 W365 Frontline 不支持使用此配置设置预配策略。 |
| sourceImageWithDiskEncryptionSetNotSupported | 指示上传的映像使用具有客户管理的密钥的磁盘加密集，Windows 365不支持该密钥。 上传使用平台管理的密钥加密的新映像。 |
| sourceImageWithAzureDiskEncryptionNotSupported | 指示上传的映像是从启用了Azure磁盘加密的Azure虚拟机捕获的，Windows 365不支持该加密。 上传仅使用平台管理的密钥加密的 VM 捕获的新映像。 |
cloudPcDeviceImageOsStatus 值
| 成员 | 说明 |
|---|---|
| 支持 | 指示云电脑设备映像作系统处于活动状态并已准备好用于预配。 |
| supportedWithWarning | 指示云电脑设备映像作系统已过期，但云电脑继续支持。 如果用户继续使用它，他们可能无法获取安全更新。 |
| unknown | 默认值。 指示云电脑设备的作系统映像状态未知。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
cloudPcDeviceImageStatus 值
| 成员 | 说明 |
|---|---|
| 待定 | 图像上传正在进行中。 |
| 准备 | 映像已准备好在云电脑上使用。 |
| 警告 | 指示在某些情况下可能无法预配上传的云电脑映像。 有关详细信息，请参阅错误消息。 |
| 失败 | 指示无法上传映像。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
cloudPcDeviceImageStatusDetails 值
| 成员 | 说明 |
|---|---|
| internalServerError | 处理图像期间发生内部服务器错误。 |
| sourceImageNotFound | 源图像不可访问或找不到。 |
| osVersionNotSupported | 不支持 OS 版本。 |
| sourceImageInvalid | 源映像对于预配 Windows 虚拟机 (VM) 无效。 |
| sourceImageNotGeneralized | 上传的图像不会通用化。 运行 sysprep/generalize 命令后重新上传映像。 若要了解详细信息，请参阅 在创建映像之前通过取消预配或通用化 VM 来删除特定于计算机的信息。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| vmAlreadyAzureAdJoined | 生成源映像的 VM，用于创建加入Microsoft Entra的设备映像。 它阻止验证过程允许使用此类源映像创建设备映像。 |
| paidSourceImageNotSupport | 此源映像是从Azure市场的另一个付费映像生成的，不受支持;请使用其他源继续。 |
| sourceImageNotSupportCustomizeVMName | 生成的通用化映像上存在计算机名称设置问题，这阻止使用提供的映像自定义 VM 名称。 |
| sourceImageSizeExceedsLimitation | 客户上传的源映像的大小超出了共享映像库 (SIG) 限制，从而导致映像创建失败。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.cloudPcDeviceImage",
"displayName": "String",
"errorCode": "String",
"expirationDate": "String (timestamp)",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"operatingSystem": "String",
"osBuildNumber": "String",
"osStatus": "String",
"osVersionNumber": "String",
"sizeInGB": "Int32",
"sourceImageResourceId": "String",
"status": "String",
"statusDetails": "String",
"version": "String"
}