名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド管理の仮想デスクトップを表します。 このクラウド PC も Intune に登録され、Microsoft エンドポイント マネージャー ポータルを通じて管理されるため、クラウド PC にも対応する Intune 管理対象のデバイス ID があります。
メソッド
プロパティ
| プロパティ |
型 |
説明 |
| aadDeviceId |
文字列 |
クラウド PC の Microsoft Entra デバイス ID。 |
| allotmentDisplayName |
文字列 |
割り当て名によって、テナント ライセンスが小さなバッチまたはグループに分割されるため、特定の割り当てで使用できるライセンスの数を制限できます。
provisioningType が dedicated の場合、割り当て名は null です。 読み取り専用です。 |
| connectivityResult |
cloudPcConnectivityResult |
クラウド PC の接続正常性チェック結果。更新されたタイムスタンプとクラウド PC が接続可能かどうかが含まれます。 |
| connectionSetting |
cloudPcConnectionSetting |
クラウド PC の接続設定。 使用可能な値: enableSingleSignOn。 読み取り専用です。 |
| deviceRegionName |
文字列 |
クラウド PC が現在プロビジョニングされている地理的リージョンの名前。 たとえば、 westus3、 eastus2、 southeastasia などです。 読み取り専用です。 |
| disasterRecoveryCapability |
cloudPcDisasterRecoveryCapability |
クラウド PC のディザスター リカバリー状態 (プライマリ リージョン、セカンダリ リージョン、機能の種類など)。 ディザスター リカバリー設定が無効になっていることを示す既定値は null です。
disasterRecoveryCapability プロパティを持つ応答を受信するには、要求 URL にdisasterRecoveryCapability/{subProperty}して応答を$selectして$filterします。 詳細については、「 例 3: ディザスター リカバリー機能の種類でフィルター処理されたクラウド PC を一覧表示する」を参照してください。 読み取り専用です。 |
| diskEncryptionState |
cloudPcDiskEncryptionState |
クラウド PC に適用されているディスク暗号化。 使用可能な値: notAvailable、notEncrypted、encryptedUsingPlatformManagedKey、encryptedUsingCustomerManagedKey、unknownFutureValue。 |
| displayName |
文字列 |
クラウド PC の表示名。 |
| gracePeriodEndDateTime |
DateTimeOffset |
猶予期間が終了し、再プロビジョニングまたはプロビジョニング解除が行われる日時。 状態が inGracePeriod の場合にのみ必須です。 タイムスタンプは ISO 8601 形式と協定世界時 (UTC) で表示されます。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| groupDetail |
cloudPcEntraGroupDetail |
ユーザーの予約クラウド PC の割り当てに関連付けられている Entra ID グループの Microsoft Entra グループの詳細 (ID や表示名など)。 読み取り専用です。 |
| id |
文字列 |
クラウド PC の一意の識別子。 読み取り専用です。 |
| imageDisplayName |
文字列 |
クラウド PC 上の OS イメージの名前。 |
| isDisasterRecoveryActive |
ブール型 |
フェールオーバー イベント後にクラウド PC が障害回復リージョンで現在実行されているかどうかを示します。
true クラウド PC が現在ディザスター リカバリー リージョンで実行されている場合。それ以外の場合は、 false。 読み取り専用です。 |
| lastLoginResult |
cloudPcLoginResult |
クラウド PC の最後のログイン結果。 たとえば、「 { "time": "2014-01-01T00:00:00Z"} 」のように入力します。 |
| lastLogoffDateTime |
DateTimeOffset |
ユーザーがクラウド PC セッションから最後にログオフした日時。 ユーザーがセッションを確立していないか、セッションが現在アクティブな場合に null を返します。 タイムスタンプは ISO 8601 形式で表示され、常に UTC になります。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。
$select で明示的に選択された場合にのみ返されます。 |
| lastModifiedDateTime |
DateTimeOffset |
クラウド PC の最終更新日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| lastRemoteActionResult |
cloudPcRemoteActionResult |
エンタープライズ クラウド PC の最後のリモート アクションの結果。 サポートされているリモート アクションは、 Reboot、 Rename、 Reprovision、 Restore、 Troubleshoot です。 |
| managedDeviceId |
文字列 |
クラウド PC の Intune デバイス ID。 |
| managedDeviceName |
文字列 |
クラウド PC の Intune デバイス名。 |
| onPremisesConnectionName |
文字列 |
クラウド PC のプロビジョニング中に適用される Azure ネットワーク接続。 |
| osVersion |
cloudPcOperatingSystem |
クラウド PC でプロビジョニングするオペレーティング システム (OS) のバージョン。 使用可能な値: windows10、windows11、unknownFutureValue。 |
| partnerAgentInstallResults |
cloudPcPartnerAgentInstallResult コレクション |
クラウド PC における各パートナー エージェントのインストール状態の結果。 |
| powerState |
cloudPcPowerState |
クラウド PC の電源状態。 使用可能な値: running、poweredOff、unknown。 このプロパティは、シフト勤務クラウド PC のみをサポートします。 |
| productType |
cloudPcProductType |
クラウド PC の製品の種類。 使用可能な値: enterprise、frontline、devBox、powerAutomate、business、unknownFutureValue。
enterprise、frontline、business で利用可能なサービス プランと価格については、「Windows 365 for business 」を参照してください。
devBox の価格情報については、「Microsoft Dev Box の価格」を参照してください。
powerAutomate で利用可能なプランと価格については、「Power Automate の価格」を参照してください。 既定値は enterprise です。
$filter と $select をサポートします。 詳細については、「 例 4: 製品タイプでフィルター処理されたクラウド PC を一覧表示する」を参照してください。 読み取り専用です。 |
| provisionedDateTime |
DateTimeOffset |
クラウド PC の最初のプロビジョニングまたはその後の再プロビジョニング中に自動的に生成および割り当てられた、最新のプロビジョニング日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| provisioningConfiguration |
cloudPcProvisioningConfiguration |
クラウド PC のポリシー派生構成。 最新のプロビジョニングまたは再プロビジョニング時に適用されたプロビジョニング ポリシーから継承されたプロパティが含まれます。
$select で明示的に選択された場合にのみ返されます。 読み取り専用です。 |
| provisioningPolicyId |
文字列 |
クラウド PC のプロビジョニング ポリシー ID。 |
| provisioningPolicyName |
文字列 |
クラウド PC のプロビジョニング中に適用されるプロビジョニング ポリシー。 |
| provisioningType |
cloudPcProvisioningType |
このポリシーを使用してクラウド PC をプロビジョニングするときに使用するライセンスの種類。 使用可能な値: dedicated、shared、unknownFutureValue、sharedByUser、sharedByEntraGroup、reserve。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から sharedByUser、sharedByEntraGroup、reserve の値を取得します。 既定値は dedicated です。
shared メンバーは非推奨となり、2027 年 4 月 30 日に戻らなくなります。今後はsharedByUserメンバーを使用します。 |
| scopeIds |
String collection |
対応するアクセス許可のスコープ ID。 現在、これは Intune スコープ タグ ID です。 読み取り専用です。 |
| servicePlanId |
文字列 |
クラウド PC のサービス プラン ID。 |
| servicePlanName |
文字列 |
クラウド PC のサービス プラン名。 |
| servicePlanType |
cloudPcServicePlanType |
クラウド PC のサービス プランの種類。 |
| sharedDeviceDetail |
cloudPcFrontlineSharedDeviceDetail |
ユーザーの UPN やセッションの開始日時など、現場共有サービス プランに関連付けられているクラウド PC デバイスの詳細を示します。 |
| status |
cloudPcStatus |
クラウド PC の状態。 可能な値は、 notProvisioned、 provisioning、 provisioned、 inGracePeriod、 deprovisioning、 failed、 provisionedWithWarnings、 resizing、 restoring、 pendingProvision、 unknownFutureValue、 movingRegion、 resizePendingLicense、 modifyingSingleSignOn、 refreshPolicyConfiguration、 preparing、 failoverInProgress、 failbackInProgress です。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から movingRegion、resizePendingLicense、modifyingSingleSignOn、refreshPolicyConfiguration、preparing、failoverInProgress、failbackInProgress の値を取得します。 |
| statusDetail |
cloudPcStatusDetail |
エラー/警告コード、エラー/警告メッセージ、additionalInformation など、クラウド PC に関連付けられている詳細な状態を示します。 たとえば、「 { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null } 」のように入力します。 |
| userAccountType |
cloudPcUserAccountType |
プロビジョニングされたクラウド PC 上のユーザーのアカウントの種類。 使用可能な値: standardUser、administrator、unknownFutureValue。 |
| userExperienceType |
cloudPcUserExperienceType |
エンド ユーザーがアクセスできるクラウド オブジェクトの種類を指定します。 使用可能な値: cloudPc、cloudApp、unknownFutureValue。
cloudPc に設定すると、エンド ユーザーがデスクトップ全体にアクセスできることを示します。
cloudApp に設定すると、エンド ユーザーは関連するプロビジョニング ポリシーの下で公開されたクラウド アプリにのみアクセスできることを示します。 クラウド アプリ エクスペリエンスでは、クラウド PC デバイスの一覧に表示されるクラウド PC デバイスも作成されるため、このプロパティはそれらを区別するのに役立ちます。 既定値は cloudPc です。 このプロパティは、プロビジョニング ポリシーで定義されています。 |
| userDetail |
cloudPcEntraUserDetail |
予約クラウド PC の割り当てに関連付けられているユーザーのユーザーの詳細 (ID や表示名など)。 読み取り専用です。 |
| userPrincipalName |
String |
クラウド PC に割り当てられているユーザーのユーザー プリンシパル名 (UPN)。 |
| connectionSettings (非推奨) |
cloudPcConnectionSettings |
クラウド PC の接続設定。 使用可能な値: enableSingleSignOn。 読み取り専用です。 このプロパティは非推奨となり、2024 年 8 月 31 日にデータの再調整が停止されました。 以降は、 connectionSetting プロパティを使用します。 |
| frontlineCloudPcAvailability (非推奨) |
frontlineCloudPcAvailability |
現場に割り当てられたクラウド PC の現在の可用性。 使用可能な値: notApplicable、 available、 notAvailable、 unknownFutureValue。 既定値は、notApplicable です。 読み取り専用です。 このプロパティは非推奨であり、2025 年 10 月 30 日にデータの返しを停止します。 今後は retrieveFrontlineCloudPcDetail API を使用します。 |
| statusDetails (非推奨) |
cloudPcStatusDetails |
クラウド PC の状態の詳細。 たとえば、「 { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null } 」のように入力します。 このプロパティは非推奨となり、2024 年 8 月 31 日をもってサポートされなくなります。 代わりに statusDetail を使用してください。 |
cloudPcDiskEncryptionState 値
| メンバー |
説明 |
| notAvailable |
クラウド PC がプロビジョニングされていないか、暗号化が使用できない状態です。 |
| notEncrypted |
クラウド PC は暗号化されているはずですが、暗号化はまだ行われていません (予約済みであるため、発生しません)。 |
| encryptedUsingPlatformManagedKey |
クラウド PC は、プラットフォーム マネージド キーを使用して暗号化されます。 カスタマー マネージド キーが有効になっていない場合、このメンバーは既定値です。 |
| encryptedUsingCustomerManagedKey |
クラウド PC はカスタマー マネージド キーを使用して暗号化されます。 |
| unknownFutureValue |
進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcPowerState 値
| メンバー |
説明 |
| 実行中 |
クラウド PC の状態は Running です。 |
| poweredOff |
クラウド PC の状態は電源オフです。 |
| 不明 |
クラウド PC の状態が不明です。 |
cloudPcStatus 値
| メンバー |
説明 |
| notProvisioned |
クラウド PC はまだプロビジョニングされていません。 |
| プロビジョニング |
クラウド PC のプロビジョニングが進行中です。 |
| 準備済み |
クラウド PC がプロビジョニングされ、ユーザーがアクセスできます。 |
| inGracePeriod |
クラウド PC は、プロビジョニングを解除する前の 1 週間の猶予期間にあります。 |
| プロビジョニング解除 |
クラウド PC はプロビジョニングを解除しています。 |
| 失敗 |
クラウド PC での操作に失敗しました。 |
| provisionedWithWarnings |
クラウド PC がプロビジョニングされ、エンド ユーザーは警告しながらアクセスできます。 ユーザーは引き続きこのクラウド PC を使用できます。 |
| サイズ変更 |
クラウド PC のサイズを変更しています。 |
| 復元 |
クラウド PC は復元中です。 |
| pendingProvision |
クラウド PC でプロビジョニングが保留中です。 この場合、猶予期間のクラウド PC の台数は、使用可能なライセンスの合計数より多くなります。 |
| unknownFutureValue |
進化可能な列挙センチネル値。 使用しないでください。 |
| movingRegion |
クラウド PC があるリージョンから別のリージョンに移動されることを示します。 |
| resizePendingLicense |
クラウド PC のサイズ変更プロセスが開始されましたが、ターゲット ライセンスが識別されていないため完了できなかったことを示します。 現在、ライセンスの問題を解決するためのお客様のアクションを待機しています。 |
| modifyingSingleSignOn |
クラウド PC がシングル サインオン設定を更新していることを示します。 |
| refreshPolicyConfiguration |
クラウド PC が新しいポリシー構成を更新中であることを示します。 |
| 準備中 |
クラウド PC が IT 管理者が定義した構成 (アプリケーション、構成、セキュリティ) で準備していることを示し、プロビジョニング状態の後に表示されます。現場の共有デバイスにのみ適用されます。 |
| failoverInProgress |
クラウド PC のディザスター リカバリー リージョンへのフェールオーバーが進行中であることを示します。 |
| failbackInProgress |
クラウド PC のプライマリ リージョンへのフェールバックが進行中であることを示します。 |
frontlineCloudPcAccessState 値
| メンバー |
説明 |
| 未割り当て |
クラウド PC が共有使用ライセンスを使用しない場合は、未割り当てに設定します。 既定値は unassigned です。 |
| noLicensesAvailable (非推奨) |
すべての共有使用ライセンスが使用中であることを示します。
noLicensesAvailable メンバーは非推奨となり、2024 年 9 月 30 日に戻らなくなります。 |
| activationFailed |
ユーザーがフロントライン クラウド PC を要求した後、フロントライン クラウド PC のライセンス認証が失敗したことを示します。 |
| アクティブ |
現場のクラウド PC が共有使用ライセンスが割り当てられたアクティブな状態であり、ユーザーがクラウド PC に接続できることを示します。 |
| ライセンス認証 |
ユーザーがクラウド PC への接続を要求し、サービスが開始していることを示します。 |
| standbyMode |
現場のクラウド PC がシャットダウンされて割り当て解除される前にスタンバイ状態であることを示します。 スタンバイ状態の現場のクラウド PC には、ユーザーは引き続きアクセスできます。 |
| unknownFutureValue |
進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcProductType 値
| メンバー |
説明 |
| Enterprise |
既定値。 無制限の数のユーザーに対して組織全体にクラウド PC を展開する大企業向けのクラウド PC organization 製品の種類を示します。 |
| フロントライン |
現場担当者とパートタイム ワーカーがデバイスを共有し、シフト中にクラウド PC を使用できるクラウド PC 製品の種類を示します。 |
| devBox |
開発者、開発チーム、IT プロフェッショナル向けのツール、サービス、リソースが事前構成されたクラウド PC 製品の種類を示します。 |
| powerAutomate |
Power Automate のお客様がクラウド PC で有人および無人 RPA (ロボティック プロセス オートメーション) を実行するためのクラウド PC 製品の種類を示します。 |
| ビジネス |
最大 300 人のユーザーを持つ中小企業のお客様向けのクラウド PC 製品の種類を示します。 |
| unknownFutureValue |
進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"allotmentDisplayName": "String",
"connectivityResult": {"@odata.type": "microsoft.graph.cloudPcConnectivityResult"},
"connectionSetting": {"@odata.type": "microsoft.graph.cloudPcConnectionSetting"},
"connectionSettings": {"@odata.type": "microsoft.graph.cloudPcConnectionSettings"},
"deviceRegionName": "String",
"disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
"diskEncryptionState": "String",
"displayName": "String",
"gracePeriodEndDateTime": "String (timestamp)",
"groupDetail": {"@odata.type": "microsoft.graph.cloudPcEntraGroupDetail"},
"id": "String (identifier)",
"imageDisplayName": "String",
"isDisasterRecoveryActive": "Boolean",
"lastLoginResult": "String",
"lastLoginResult": {"@odata.type": "microsoft.graph.cloudPcLoginResult"},
"lastLogoffDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"lastRemoteActionResult": {"@odata.type": "microsoft.graph.cloudPcRemoteActionResult"},
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"osVersion": "String",
"partnerAgentInstallResults": [{"@odata.type": "microsoft.graph.cloudPcPartnerAgentInstallResult"}],
"powerState": "String",
"productType": "String",
"provisionedDateTime": "String (timestamp)",
"provisioningConfiguration": {"@odata.type": "microsoft.graph.cloudPcProvisioningConfiguration"},
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"servicePlanType": "String",
"scopeIds": ["String"],
"sharedDeviceDetail": {"@odata.type": "microsoft.graph.cloudPcFrontlineSharedDeviceDetail"},
"status": "String",
"statusDetail": {"@odata.type": "microsoft.graph.cloudPcStatusDetail"},
"userAccountType": "String",
"userExperienceType": "String",
"userDetail": {"@odata.type": "microsoft.graph.cloudPcEntraUserDetail"},
"userPrincipalName": "String"
}