名前空間: microsoft.graph
クラウド PC 上のイメージ リソースを表します。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | cloudPcDeviceImage コレクション | Cloud PC にアップロードされた cloudPcDeviceImage オブジェクト (オペレーティング システム イメージ) のプロパティとリレーションシップを一覧表示します。 |
| Get | cloudPcDeviceImage | 特定の cloudPcDeviceImage オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Create | cloudPcDeviceImage | 新しい cloudPcDeviceImage オブジェクトを作成します。 |
| 削除 | なし | cloudPcDeviceImage オブジェクトを削除します。 |
| ソース画像を取得する | cloudPcSourceDeviceImage コレクション | クラウド PC でアップロードおよび使用できる cloudPcSourceDeviceImage オブジェクトを取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| displayName | 文字列 | 関連付けられているデバイス イメージの表示名。 デバイス イメージの表示名とバージョンは、クラウド PC デバイス イメージを一意に識別するために使用されます。 読み取り専用です。 |
| errorCode | cloudPcDeviceImageErrorCode | アップロードが失敗した理由 (該当する場合) を示すイメージの状態のエラー コード。 使用可能な値: internalServerError、sourceImageNotFound、osVersionNotSupported、sourceImageInvalid、sourceImageNotGeneralized、unknownFutureValue、vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。vmAlreadyAzureAdJoined、paidSourceImageNotSupport、sourceImageNotSupportCustomizeVMName、sourceImageSizeExceedsLimitation。 読み取り専用です。 |
| expirationDate | Date | イメージが使用できなくなった日付。 読み取り専用です。 |
| id | 文字列 | クラウド PC 上のイメージ リソースの一意識別子 (ID)。 読み取り専用です。 エンティティから継承 されます。 |
| lastModifiedDateTime | DateTimeOffset | イメージが最後に変更されたデータと時刻。 タイムスタンプは、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 |
| operatingSystem | 文字列 | イメージのオペレーティング システム (OS)。 たとえば、「 Windows 11 Enterprise 」のように入力します。 読み取り専用です。 |
| osBuildNumber | 文字列 | イメージの OS ビルド バージョン。 たとえば、「 1909 」のように入力します。 読み取り専用です。 |
| osStatus | cloudPcDeviceImageOsStatus | このイメージの OS 状態。 使用可能な値: supported、supportedWithWarning、unknown、unknownFutureValue。 既定値は unknown です。 読み取り専用です。 |
| sourceImageResourceId | 文字列 | Azureのソース イメージ リソースの一意識別子 (ID)。 必要な ID 形式は、"/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}" です。 読み取り専用です。 |
| status | cloudPcDeviceImageStatus | クラウド PC 上のイメージの状態。 使用可能な値: pending、ready、failed、unknownFutureValue。 読み取り専用です。 |
| version | 文字列 | イメージのバージョン。 たとえば、0.0.1 および 1.5.13 などです。 読み取り専用です。 |
cloudPcDeviceImageErrorCode 値
| メンバー | 説明 |
|---|---|
| internalServerError | イメージの処理中に内部サーバー エラーが発生したことを示します。 |
| sourceImageNotFound | ソース イメージにアクセスできないか、見つからないことを示します。 |
| osVersionNotSupported | オペレーティング システムのバージョンがサポートされていないことを示します。 |
| sourceImageInvalid | ソース イメージが Windows 仮想マシン (VM) のプロビジョニングに無効であることを示します。 |
| sourceImageNotGeneralized | アップロードされたイメージが一般化されていないことを示します。 sysprep/generalize コマンドを実行した後、イメージを再アップロードします。 詳細については、「イメージを 作成する前に VM のプロビジョニングを解除または一般化して、コンピューター固有の情報を削除する」を参照してください。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
| vmAlreadyAzureAdJoined | デバイス イメージを作成するためのソース イメージを生成する VM が既にMicrosoft Entraに参加していることを示します。 これにより、検証プロセスでは、このようなソース イメージを使用してデバイス イメージを作成できなくなります。 |
| paidSourceImageNotSupport | このソース イメージが、Azure Marketplace の別の有料イメージから構築され、サポートされていないことを示します。別のソースを使用して続行します。 |
| sourceImageNotSupportCustomizeVMName | 結果として生成される一般化されたイメージにコンピューター名設定の問題が存在し、指定されたイメージを使用して VM 名をカスタマイズできないようにすることを示します。 |
| sourceImageSizeExceedsLimitation | お客様がアップロードしたソース イメージのサイズが共有イメージ ギャラリー (SIG) の制限を超えているので、イメージの作成が失敗することを示します。 |
cloudPcDeviceImageOsStatus 値
| メンバー | 説明 |
|---|---|
| サポートされる | クラウド PC デバイス イメージ オペレーティング システムがアクティブであり、プロビジョニングに使用する準備ができていることを示します。 |
| supportedWithWarning | クラウド PC デバイス イメージ オペレーティング システムの有効期限が切れているが、クラウド PC が引き続きサポートされていることを示します。 ユーザーが引き続き使用する場合、セキュリティ更新プログラムを入手できない可能性があります。 |
| 不明 | 既定値。 クラウド PC デバイスのオペレーティング システム イメージの状態が不明であることを示します。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcDeviceImageStatus 値
| メンバー | 説明 |
|---|---|
| ペンディング | イメージのアップロードが進行中であることを示します。 |
| 準備完了 | クラウド PC でイメージを使用する準備ができていることを示します。 |
| 失敗 しました | イメージのアップロードに失敗したことを示します。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
なし。
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",
"sourceImageResourceId": "String",
"status": "String",
"version": "String"
}