cloudPC リソースの種類
[アーティクル] 11/19/2024
28 人の共同作成者
フィードバック
この記事の内容
名前空間: 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"
}