名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウドで管理される仮想デスクトップを表します。 このクラウド PC は、Intuneにも登録され、Microsoft Endpoint Manager ポータルを介して管理されるため、クラウド PC には対応するIntuneマネージド デバイス ID も含まれます。
メソッド
プロパティ
プロパティ |
型 |
説明 |
aadDeviceId |
String |
クラウド PC のMicrosoft Entraデバイス ID。 |
allotmentDisplayName |
String |
割り当て名は、テナント ライセンスを小さなバッチまたはグループに分割し、特定の割り当てで使用できるライセンスの数を制限するのに役立ちます。
provisioningType がdedicated されると、割り当て名がnull されます。 読み取り専用です。 |
connectivityResult |
cloudPcConnectivityResult |
接続の正常性チェック、更新されたタイムスタンプやクラウド PC を接続できるかどうかなど、クラウド PC の結果です。 |
deviceRegionName |
String |
クラウド 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 |
String |
クラウド PC の表示名。 |
frontlineCloudPcAvailability |
frontlineCloudPcAvailability |
現場で割り当てられたクラウド PC の現在の可用性。 使用可能な値: notApplicable 、 available 、notAvailable 、 unknownFutureValue 。 既定値は、notApplicable です。 読み取り専用です。 |
gracePeriodEndDateTime |
DateTimeOffset |
猶予期間が終了し、再プロビジョニングまたはプロビジョニング解除が行われる日時。 状態が inGracePeriod されている場合にのみ必要です。 タイムスタンプは ISO 8601 形式と協定世界時 (UTC) で表示されます。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
id |
String |
クラウド PC の一意の識別子。 読み取り専用です。 |
imageDisplayName |
String |
クラウド 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 |
String |
クラウド PC のIntuneデバイス ID。 |
managedDeviceName |
String |
クラウド PC のIntuneデバイス名。 |
onPremisesConnectionName |
String |
クラウド 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 を一覧表示する」を参照してください。 読み取り専用です。 |
provisioningPolicyId |
String |
クラウド PC のプロビジョニング ポリシー ID。 |
provisioningPolicyName |
String |
クラウド PC のプロビジョニング中に適用されるプロビジョニング ポリシー。 |
provisioningType |
cloudPcProvisioningType |
このポリシーを使用してクラウド PC をプロビジョニングするときに使用するライセンスの種類。 使用可能な値は、 dedicated 、 shared 、 unknownFutureValue 、sharedByUser 、 sharedByEntraGroup です。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します:sharedByUser 、sharedByEntraGroup 。 既定値は dedicated です。 注意: shared メンバーは非推奨となり、2027 年 4 月 30 日に戻りを停止します。今後は、 sharedByUser メンバーを使用します。 |
servicePlanId |
String |
クラウド PC のサービス プラン ID。 |
servicePlanName |
String |
クラウド PC のサービス プラン名。 |
servicePlanType |
cloudPcServicePlanType |
クラウド 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 です。 |
userPrincipalName |
String |
クラウド PC に割り当てられているユーザーのユーザー プリンシパル名 (UPN)。 |
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 |
進化可能な列挙センチネル値。 使用しないでください。 |
frontlineCloudPcAvailability 値
メンバー |
説明 |
notApplicable |
既定値。 クラウド PC は、現場割り当て型ではありません。 |
使用可能 |
現在の現場のクラウド PC を使用でき、ユーザーはそれに接続できます。 |
notAvailable |
現在、現場のクラウド 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",
"deviceRegionName": "String",
"disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
"diskEncryptionState": "String",
"displayName": "String",
"gracePeriodEndDateTime": "String (timestamp)",
"id": "String (identifier)",
"imageDisplayName": "String",
"lastLoginResult": "String",
"lastModifiedDateTime": "String (timestamp)",
"lastRemoteActionResult": "String",
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"powerState": "String",
"osVersion": "String",
"partnerAgentInstallResults": "String",
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"servicePlanType": "String",
"status": "String",
"userAccountType": "String",
"userPrincipalName": "String"
}