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