名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウドで管理される仮想デスクトップを表します。 このクラウド PC は Intune にも登録され、Microsoft エンドポイント マネージャー ポータルを介して管理されるため、クラウド PC には対応する Intune で管理されるデバイス ID も含まれます。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List cloudPCs | cloudPC コレクション | クラウド PC オブジェクトのプロパティとリレーションシップを一覧表示します。 |
| cloudPC を取得する | cloudPC | クラウド PC オブジェクトのプロパティとリレーションシップを読み取ります。 |
| プロビジョニングされたクラウド PC を取得する | cloudPC コレクション | Microsoft Entra ユーザー グループのユーザーに対して、特定のサービス プランのすべてのプロビジョニング済みクラウド PC を取得します。 |
| ユーザー アカウントの種類を変更する | なし | 特定のクラウド PC 上のユーザーのアカウントの種類を変更します。 |
| 猶予期間の終了 | なし | クラウド PC オブジェクトの猶予期間を終了します。 |
| 電源オン | なし | 特定の Windows Frontline Cloud PC オブジェクトの電源をオンにします。 このアクションは、MEM 管理シナリオをサポートします。 |
| 電源オフ | なし | 特定の Windows Frontline Cloud PC オブジェクトの電源をオフにします。 このアクションは、MEM 管理シナリオをサポートします。 |
| 再起動 | なし | 特定のクラウド PC オブジェクトを再起動します。 |
| Rename | なし | 特定のクラウド PC オブジェクトの名前を変更します。 この API を使用して、Cloud PC エンティティの displayName を更新します。 |
| 再プロビジョニング | なし | クラウド PC オブジェクトを再プロビジョニングします。 |
| Resize | なし | 新しい仮想 CPU (vCPU) とストレージ サイズを使用して、既存の クラウド PC を構成にアップグレードまたはダウングレードします。 |
| Start | なし | 特定のクラウド PC を起動します。 現時点では、Windows 365 Frontlineクラウド PC のみがサポートされています。 |
| Stop | なし | 特定のクラウドを停止します。 現時点では、Windows 365 Frontlineクラウド PC のみがサポートされています。 |
| トラブルシューティング | なし | 特定のクラウド PC オブジェクトのトラブルシューティングを行います。 この API を使用して、クラウド PC とセッション ホストの正常性状態をチェックします。 |
| 復元 | なし | クラウド PC オブジェクトをスナップショットから以前の状態に復元します。 |
| レビューの状態を設定する | なし | クラウド PC ID を使用して、特定のクラウド PC デバイスのレビュー状態を設定します。 |
| レビューの状態を取得する | cloudPcReviewStatus | クラウド PC の レビュー状態 を取得します。 |
| 状態別にクラウド PC の数を取得する | cloudPcStatusSummary コレクション | 状態別にグループ化された クラウド PC の数を取得します。 |
| ユーザーの一覧 | cloudPC コレクション | サインインしているユーザーに属性が設定されているクラウド PC デバイスを一覧表示します。 |
| 起動の詳細を取得する | cloudPcLaunchDetail | 現在サインインしているユーザーに属する特定のクラウド PC の cloudPcLaunchDetail を取得します。 |
| 接続履歴を取得する | cloudPcConnectivityEvent コレクション | クラウド PC の接続履歴を取得します。 |
| サポートされているリモート アクションを取得する | cloudPcRemoteActionCapability コレクション | アクションの名前と機能など、特定のクラウド PC デバイスでサポートされているクラウド PC リモート アクションの一覧を取得します。 |
| リモート アクションの結果を取得する | cloudPcRemoteActionResult コレクション | リモート アクションの結果を取得し、関連付けられているクラウド PC デバイスで実行された特定のリモート アクションの状態をチェックします。 |
| パートナー エージェントのインストールを再試行する | なし | クラウド PC へのインストールに失敗したパートナー エージェントのインストールを再試行します。 |
| 一括サイズ変更の検証 | cloudPcResizeValidateResult コレクション | 一連のクラウド PC デバイスが、一括サイズ変更の要件を満たしていることを検証します。 |
| スナップショットの作成 | なし | 特定のクラウド PC デバイスのスナップショットを作成します。 |
| スナップショットを取得する | cloudPcSnapshot コレクション | クラウド PC の cloudPcSnapshot リソースの一覧を取得します。 |
| 現場のアクセス状態を取得する | frontlineCloudPcAccessState | 現場のクラウド PC のアクセス状態を取得します。 使用可能な値: unassigned、noLicensesAvailable、activationFailed、active、activating、standbyMode、unknownFutureValue。
noLicensesAvailable メンバーは非推奨となり、2024 年 9 月 30 日に戻りを停止しました。 |
| 起動情報を取得する (非推奨) | cloudPcLaunchInfo | 現在サインインしているユーザーに属する特定のクラウド PC の cloudPCLaunchInfo を取得します。 この API は非推奨であり、2026 年 10 月 30 日にデータの返しを停止します。 今後は、起動の 詳細の取得 API を使用します。 |
| 現場のクラウド PC の詳細を取得する | frontlineCloudPcDetail | 現場のクラウド PC の frontlineCloudPcDetail を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| aadDeviceId | 文字列 | クラウド PC のMicrosoft Entraデバイス ID。 |
| allotmentDisplayName | 文字列 | 割り当て名は、テナント ライセンスを小さなバッチまたはグループに分割し、特定の割り当てで使用できるライセンスの数を制限するのに役立ちます。
provisioningType がdedicatedされると、割り当て名がnullされます。 読み取り専用です。 |
| connectivityResult | cloudPcConnectivityResult | 接続の正常性チェック、更新されたタイムスタンプやクラウド PC を接続できるかどうかなど、クラウド PC の結果です。 |
| 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 イメージの名前。 |
| lastLoginResult | cloudPcLoginResult | クラウド PC の最後のログイン結果。 たとえば、「 { "time": "2014-01-01T00:00:00Z"} 」のように入力します。 |
| 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 です。 |
| 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 メンバーを使用します。 |
| 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、 preparingです。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します。movingRegion、resizePendingLicense、modifyingSingleSignOn、preparing。 |
| statusDetail | cloudPcStatusDetail | クラウド PC に関連付けられている詳細な状態 (エラー/警告コード、エラー/警告メッセージ、additionalInformation など) を示します。 たとえば、「 { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null } 」のように入力します。 |
| connectionSetting | cloudPcConnectionSetting | クラウド PC の接続設定。 使用可能な値: enableSingleSignOn。 読み取り専用です。 |
| 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 の状態が実行中です。 |
| poweredOff | クラウド PC の状態がオフになっています。 |
| 不明 | クラウド PC の状態が不明です。 |
cloudPcStatus 値
次の表に、 進化可能な列挙体のメンバーを示します。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得する必要があります:movingRegion、resizePendingLicense、modifyingSingleSignOn、preparing。
| メンバー | 説明 |
|---|---|
| notProvisioned | クラウド PC はまだプロビジョニングされていません。 |
| プロビジョニング | クラウド PC のプロビジョニングが進行中です。 |
| 準備済み | クラウド PC がプロビジョニングされ、ユーザーがアクセスできます。 |
| inGracePeriod | クラウド PC は、プロビジョニング解除前の 1 週間の猶予期間にあります。 |
| プロビジョニング解除 | クラウド PC はプロビジョニング解除中です。 |
| 失敗 しました | クラウド PC での操作に失敗しました。 |
| provisionedWithWarnings | クラウド PC がプロビジョニングされ、エンド ユーザーは警告とともにアクセスできます。 ユーザーはこのクラウド PC を引き続き使用できます。 |
| サイズ | クラウド PC のサイズが変更されています。 |
| pendingProvision | プロビジョニングはクラウド PC で保留中です。 この場合、猶予期間のクラウド PC の数は、使用可能なライセンスの合計数を超えています。 |
| 復元 | クラウド PC が復元中です。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
| movingRegion | クラウド PC がリージョン間で移動されていることを示します。 |
| resizePendingLicense | クラウド PC のサイズ変更プロセスが開始されたが、ターゲット ライセンスが特定されていないため完了できなかったことを示します。 現在、ライセンスの問題を解決するための顧客のアクションが待っています。 |
| modifyingSingleSignOn | クラウド PC がシングル サインオン設定を更新していることを示します。 |
| 準備 | プロビジョニング状態の後に、クラウド PC が IT 管理者が定義した構成 (アプリケーション、構成、セキュリティ) を使用して準備していることを示します。Frontline 共有デバイスにのみ適用されます。 |
frontlineCloudPcAccessState 値
| メンバー | 説明 |
|---|---|
| 未割り当て | クラウド PC が共有使用ライセンスを使用しない場合は、未割り当てに設定します。 既定値は unassigned です。 |
| noLicensesAvailable (非推奨) | すべての共有使用ライセンスが使用中であることを示します。
noLicensesAvailable メンバーは非推奨となり、2024 年 9 月 30 日に復帰を停止します。 |
| activationFailed | ユーザーが現場のクラウド PC を要求した後に、現場のクラウド PC のライセンス認証が失敗したことを示します。 |
| アクティブ | 現場のクラウド PC が、共有使用ライセンスが割り当てられたアクティブな状態にあり、ユーザーがクラウド PC に接続できることを示します。 |
| アクティブ 化 | ユーザーがクラウド PC とサービスの接続を要求したことを示します。 |
| standbyMode | クラウド PC がシャットダウンされて割り当て解除される前に、現場のクラウド PC がスタンバイ状態であることを示します。 スタンバイ状態の最前線のクラウド PC には、引き続きユーザーがアクセスできます。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcProductType 値
| メンバー | 説明 |
|---|---|
| エンタープライズ | 既定値。 クラウド PC を organization全体にデプロイする大規模企業向けのクラウド PC 製品の種類を示します。ユーザー数は無制限です。 |
| フロントライン | 現場担当者とパートタイム ワーカーがデバイスを共有するためのクラウド 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": "String",
"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",
"lastLoginResult": "String",
"lastModifiedDateTime": "String (timestamp)",
"lastRemoteActionResult": "String",
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"osVersion": "String",
"partnerAgentInstallResults": "String",
"powerState": "String",
"provisionedDateTime": "String (timestamp)",
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"servicePlanType": "String",
"sharedDeviceDetail": {"@odata.type": "microsoft.graph.cloudPcFrontlineSharedDeviceDetail"},
"status": "String",
"userAccountType": "String",
"userExperienceType": "String",
"userDetail": {"@odata.type": "microsoft.graph.cloudPcEntraUserDetail"},
"userPrincipalName": "String"
}