命名空间：microsoft.graph
表示云电脑上的图像资源。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | cloudPcDeviceImage 集合 | 列出 上传到云电脑的 cloudPcDeviceImage 对象的属性和关系 (操作系统映像) 。 |
| Get | cloudPcDeviceImage | 读取特定 cloudPcDeviceImage 对象的属性和关系。 |
| 创建 | cloudPcDeviceImage | 创建新的 cloudPcDeviceImage 对象。 |
| 删除 | 无 | 删除 cloudPcDeviceImage 对象。 |
| 获取源图像 | cloudPcSourceDeviceImage 集合 | 获取可在云电脑上上传和使用的 cloudPcSourceDeviceImage 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 关联设备映像的显示名称。 设备映像显示名称和版本用于唯一标识云电脑设备映像。 只读。 |
| errorCode | cloudPcDeviceImageErrorCode | 图像状态的错误代码，指示上传失败的原因（如果适用）。 可取值包括：internalServerError、sourceImageNotFound、osVersionNotSupported、sourceImageInvalid、sourceImageNotGeneralized、unknownFutureValue、vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。
Prefer: include-unknown-enum-members使用请求标头从此可演变枚举中获取以下值：vmAlreadyAzureAdJoined、paidSourceImageNotSupport、、sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 只读。 |
| expirationDate | 日期 | 映像不可用的日期。 只读。 |
| id | String | 云电脑上映像资源的唯一标识符 (ID) 。 只读。 继承自 entity。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改图像的数据和时间。 时间戳使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 |
| operatingSystem | String | 操作系统 (映像的 OS) 。 例如，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、failed、unknownFutureValue。 只读。 |
| version | String | 映像版本。 例如， 0.0.1 和 1.5.13。 只读。 |
cloudPcDeviceImageErrorCode 值
| 成员 | 说明 |
|---|---|
| internalServerError | 指示处理图像时发生内部服务器错误。 |
| sourceImageNotFound | 指示源图像不可访问或找不到。 |
| osVersionNotSupported | 指示操作系统版本不受支持。 |
| sourceImageInvalid | 指示源映像对于预配 Windows 虚拟机 (VM) 无效。 |
| sourceImageNotGeneralized | 指示上传的图像尚未通用化。 运行 sysprep/generalize 命令后重新上传映像。 若要了解详细信息，请参阅 在创建映像之前通过取消预配或通用化 VM 来删除特定于计算机的信息。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| vmAlreadyAzureAdJoined | 指示已将生成用于创建设备映像的源映像的 VM 联接到Microsoft Entra。 这可以防止验证过程允许使用此类源映像创建设备映像。 |
| paidSourceImageNotSupport | 指示此源映像是从Azure市场的另一个付费映像生成的，不受支持;请使用其他源继续。 |
| sourceImageNotSupportCustomizeVMName | 指示生成的通用化映像上存在计算机名称设置问题，这阻止使用提供的映像自定义 VM 名称。 |
| sourceImageSizeExceedsLimitation | 指示客户上传的源映像的大小超出了共享映像库 (SIG) 限制，从而导致映像创建失败。 |
cloudPcDeviceImageOsStatus 值
| 成员 | 说明 |
|---|---|
| 支持 | 指示云电脑设备映像操作系统处于活动状态并已准备好用于预配。 |
| supportedWithWarning | 指示云电脑设备映像操作系统已过期，但云电脑继续支持。 如果用户继续使用，他们可能无法获取安全更新。 |
| unknown | 默认值。 指示云电脑设备的操作系统映像状态未知。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
cloudPcDeviceImageStatus 值
| 成员 | 说明 |
|---|---|
| 等待 | 指示图像上传正在进行中。 |
| 准备 | 指示映像已准备好在云电脑上使用。 |
| 失败 | 指示无法上传映像。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.cloudPcDeviceImage",
"displayName": "String",
"errorCode": "String",
"expirationDate": "String (Date)",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"operatingSystem": "String",
"osBuildNumber": "String",
"osStatus": "String",
"osVersionNumber": "String",
"sizeInGB": "Int32",
"sourceImageResourceId": "String",
"status": "String",
"version": "String"
}