cloudPC リソースの種類

[アーティクル]
11/08/2023

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

クラウドで管理される仮想デスクトップを表します。このクラウド PC もIntuneに登録され、Microsoft Endpoint Manager ポータルを介して管理されるため、クラウド PC には対応するIntuneマネージドデバイス ID も含まれます。

メソッド

メソッド	戻り値の種類	説明
List cloudPCs	cloudPC コレクション	クラウド PC オブジェクトのプロパティとリレーションシップを一覧表示します。
cloudPC を取得する	cloudPC	クラウド PC オブジェクトのプロパティとリレーションシップを読み取ります。
プロビジョニングされたクラウド PC を取得する	cloudPC コレクション	Microsoft Entra ユーザーグループのユーザーに対して、特定のサービスプランのすべてのプロビジョニング済みクラウド PC を取得します。
ユーザーアカウントの種類を変更する	なし	特定のクラウド PC 上のユーザーのアカウントの種類を変更します。
猶予期間の終了	なし	クラウド PC オブジェクトの猶予期間を終了します。
リモートアクションの結果を取得する	cloudPcRemoteActionResult	クラウド PC デバイスのクラウド PC で指定されたリモートアクションの結果を確認します。
電源オン	なし	特定の Windows Frontline Cloud PC オブジェクトの電源をオンにします。このアクションは、MEM 管理シナリオをサポートします。
電源オフ	なし	特定の Windows Frontline Cloud PC オブジェクトの電源をオフにします。このアクションは、MEM 管理シナリオをサポートします。
再起動	なし	特定のクラウド PC オブジェクトを再起動します。
Rename	なし	特定のクラウド PC オブジェクトの名前を変更します。この API を使用して、Cloud PC エンティティの displayName を更新します。
再プロビジョニング	なし	クラウド PC オブジェクトを再プロビジョニングします。
リモートアクションの一括再プロビジョニング	なし	マネージドデバイス ID を使用して一連のクラウド PC デバイスIntune一括再プロビジョニングします。
リモートアクションのサイズを変更する	なし	マネージドデバイス ID を使用して、新しい vCPU とストレージサイズを使用して、既存のクラウド PC を別の構成Intuneアップグレードまたはダウングレードします。
Start	なし	ユーザーの特定のクラウド PC を起動します。現時点では、Windows 365 Frontlineクラウド PC のみがサポートされています。
Stop	なし	ユーザーの特定のクラウド PC を停止します。現時点では、Windows 365 Frontlineクラウド PC のみがサポートされています。
トラブルシューティング	なし	特定のクラウド PC オブジェクトのトラブルシューティングを行います。この API を使用して、クラウド PC とセッションホストの正常性状態をチェックします。
復元	なし	クラウド PC オブジェクトをスナップショットから以前の状態に復元します。
リモートアクションの一括復元	cloudPcBulkRemoteActionResult	Intuneマネージドデバイスの ID と復元ポイントの日付と時刻を含む 1 つの要求を使用して、複数のクラウド PC デバイスを復元します。
レビューの状態を設定する	なし	特定のクラウド PC デバイスのレビュー状態を設定します。
レビューの状態を取得する	cloudPcReviewStatus	特定のクラウド PC デバイスのレビュー状態を取得します。
一括セットレビューの状態	cloudPcBulkRemoteActionResult	複数のクラウド PC デバイスのレビュー状態を、Intuneマネージドデバイスの ID を含む 1 つの要求で設定します。
ユーザーの一覧	cloudPC コレクション	サインインしているユーザーに属性が設定されているクラウド PC デバイスを一覧表示します。
ユーザーの起動情報を取得する	cloudPcLaunchInfo	サインインしているユーザーの cloudPcLaunchInfo を取得します。
接続履歴を取得する	cloudPcConnectivityEvent コレクション	クラウド PC の接続履歴を取得します。
サポートされているリモートアクションを取得する	cloudPcRemoteActionCapability コレクション	アクションの名前と機能など、特定のクラウド PC デバイスでサポートされているクラウド PC リモートアクションの一覧を取得します。
パートナーエージェントのインストールを再試行する	なし	クラウド PC へのインストールに失敗したパートナーエージェントのインストールを再試行します。
一括サイズ変更	cloudPcRemoteActionResult コレクション	検証に成功したクラウド PC のグループのサイズを変更するには、一括サイズ変更アクションを実行します (cloudPC: validateBulkResize)。サイズを変更できないデバイスがある場合は、"サイズ変更に失敗しました" というラベルが付けられますが、残りのデバイスはサイズ変更プロセス用です `provisioned` 。
一括サイズ変更の検証	cloudPcResizeValidateResult コレクション	一連のクラウド PC デバイスが、一括サイズ変更の要件を満たしていることを検証します。
現場のアクセス状態を取得する	frontlineCloudPcAccessState	現場のクラウド PC のアクセス状態を取得します。使用可能な値: `unassigned`、`noLicensesAvailable`、`activationFailed`、`active`、`activating`、`standbyMode`、`unknownFutureValue`。
シフト作業アクセス状態の取得 (非推奨)	shiftWorkCloudPcAccessState	シフトワーククラウドPCのアクセス状態を取得します。使用可能な値は、、、、、`activatingactiveunknownFutureValueactivationFailedwaitlisted`です。 `standbyModenoLicensesAvailableunassigned` この進化可能な列挙型で次の`Prefer: include-unknown-enum-members`値を取得するには、要求ヘッダーを使用する必要があることに注意してください。 `standbyMode` この API は非推奨であり、2023 年 12 月 31 日にデータの返しを停止します。今後は、 getFrontlineCloudPcAccessState API を使用します。
リモートアクションの再プロビジョニング (非推奨)	なし	Intuneマネージドデバイス ID を使用してクラウド PC を再プロビジョニングします。この API は非推奨であり、2023 年 9 月 30 日にデータの返しを停止します。今後は、再プロビジョニング API を使用します。
リモートアクションの復元 (非推奨)	なし	Intuneマネージドデバイス ID を使用して、クラウド PC デバイスを以前の状態に復元します。この API は非推奨であり、2023 年 9 月 30 日にデータの返しを停止します。今後は、復元 API を使用します。

プロパティ

プロパティ	型	説明
aadDeviceId	String	クラウド PC のMicrosoft Entraデバイス ID。
allotmentDisplayName	String	割り当て名は、テナントライセンスを小さなバッチまたはグループに分割し、特定の割り当てで使用できるライセンスの数を制限するのに役立ちます。 provisioningType がの`dedicated`場合、割り当て名はです`null`。読み取り専用です。
connectivityResult	cloudPcConnectivityResult	接続の正常性チェック、更新されたタイムスタンプやクラウド PC を接続できるかどうかなど、クラウド PC の結果です。
diskEncryptionState	cloudPcDiskEncryptionState	クラウド PC に適用されたディスク暗号化。使用可能な値: `notAvailable`、`notEncrypted`、`encryptedUsingPlatformManagedKey`、`encryptedUsingCustomerManagedKey`、`unknownFutureValue`。
displayName	String	クラウド PC の表示名。
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のみをサポートします。
provisioningPolicyId	String	クラウド PC のプロビジョニングポリシー ID。
provisioningPolicyName	String	クラウド PC のプロビジョニング中に適用されるプロビジョニングポリシー。
provisioningType	cloudPcProvisioningType	このポリシーを使用してクラウド PC をプロビジョニングするときに使用するライセンスの種類。可能な値は `dedicated`、`shared`、`unknownFutureValue` です。既定値は、`dedicated` です。
servicePlanId	String	クラウド PC のサービスプラン ID。
servicePlanName	String	クラウド PC のサービスプラン名。
servicePlanType	cloudPcServicePlanType	クラウド PC のサービスプランの種類。
status	microsoft.graph.cloudPcStatus	クラウド PC の状態。可能な値は、`notProvisioned`、`provisioning`、`provisioned`、`inGracePeriod`、`deprovisioning`、`failed`、`provisionedWithWarnings`、`resizing`、`restoring`、`pendingProvision`、`unknownFutureValue`、`movingRegion`、`resizePendingLicense` です。要求ヘッダーを使用して、`Prefer: include-unknown-enum-members`この進化可能な列挙型から次の値を取得する必要があります。 `movingRegionresizePendingLicense`
statusDetails	cloudPcStatusDetails	クラウド PC の状態の詳細。
userAccountType	cloudPcUserAccountType	プロビジョニングされたクラウド PC 上のユーザーのアカウントの種類。可能な値は `standardUser`、`administrator`、`unknownFutureValue` です。
userPrincipalName	String	クラウド PC に割り当てられているユーザーのユーザープリンシパル名 (UPN)。

cloudPcDiskEncryptionState 値

メンバー	説明
notAvailable	クラウド PC がプロビジョニングされていないか、暗号化が使用できない状態です。
notEncrypted	クラウド PC は暗号化する必要がありますが、暗号化はまだ行われていません (予約済み、実行しないでください)。
encryptedUsingPlatformManagedKey	クラウド PC は、プラットフォームマネージドキーを使用して暗号化されます。カスタマーマネージドキーが有効になっていない場合、このメンバーは既定値です。
encryptedUsingCustomerManagedKey	クラウド PC は、カスタマーマネージドキーを使用して暗号化されます。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

cloudPcPowerState 値

メンバー	説明
実行	クラウド PC の状態が実行中です。
poweredOff	クラウド PC の状態は電源オフです。
不明	クラウド PC の状態が不明です。

cloudPcStatus 値

次の表に、進化可能な列挙体のメンバーを示します。この進化可能な列挙型では、要求ヘッダーをPrefer: include-unknown-enum-members使用して次の値を取得する必要があることに注意してください。 movingRegionresizePendingLicense

メンバー	説明
notProvisioned	クラウド PC はまだプロビジョニングされていません。
プロビジョニング	クラウド PC のプロビジョニングが進行中です。
準備済み	クラウド PC がプロビジョニングされ、ユーザーがアクセスできます。
inGracePeriod	クラウド PC は、プロビジョニング解除前の 1 週間の猶予期間にあります。
プロビジョニング解除	クラウド PC はプロビジョニング解除中です。
失敗しました	クラウド PC での操作に失敗しました。
provisionedWithWarnings	クラウド PC がプロビジョニングされ、エンドユーザーは警告とともにアクセスできます。ユーザーはこのクラウド PC を引き続き使用できます。
サイズ	クラウド PC のサイズが変更されています。
pendingProvision	プロビジョニングはクラウド PC で保留中です。この場合、猶予期間のクラウド PC の数は、使用可能なライセンスの合計数を超えています。
復元	クラウド PC が復元中です。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
movingRegion	クラウド PC がリージョン間で移動されていることを示します。
resizePendingLicense	クラウド PC のサイズ変更プロセスが開始されたが、ターゲットライセンスが特定されていないため完了できなかったことを示します。現在、ライセンスの問題を解決するための顧客のアクションが待っています。

frontlineCloudPcAccessState 値

メンバー	説明
未割り当て	クラウド PC が共有使用ライセンスを使用しない場合は、未割り当てに設定します。既定値は `unassigned` です。
noLicensesAvailable	すべての共有使用ライセンスが使用中であることを示します。
activationFailed	ユーザーが現場のクラウド PC を要求した後に、現場のクラウド PC のライセンス認証が失敗したことを示します。
アクティブ	現場のクラウド PC が、共有使用ライセンスが割り当てられたアクティブな状態にあり、ユーザーがクラウド PC に接続できることを示します。
アクティブ化	ユーザーがクラウド PC とサービスの接続を要求したことを示します。
standbyMode	クラウド PC がシャットダウンされて割り当て解除される前に、現場のクラウド PC がスタンバイ状態であることを示します。スタンバイ状態の最前線のクラウド PC には、引き続きユーザーがアクセスできます。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

shiftWorkCloudPcAccessState 値 (非推奨)

次の表に、進化可能な列挙体のメンバーを示します。要求ヘッダーを使用して、Prefer: include-unknown-enum-membersこの進化可能な列挙型で次の値を取得する必要があります。 standbyMode

メンバー	説明
未割り当て	クラウド PC が共有使用ライセンスを使用していない場合は、未割り当てに設定します。既定値は `unassigned` です。
noLicensesAvailable	すべての共有使用ライセンスが使用中であることを示します。
activationFailed	ユーザーがシフトワーククラウドPCを要求した後、シフトワーククラウドPCのアクティベーションが失敗したことを示します。
アクティブ	シフトワーククラウドPCが共有使用ライセンスが割り当てられたアクティブな状態にあり、ユーザーがクラウドPCに接続できることを示します。
アクティブ化	ユーザーがクラウド PC とサービスの接続を要求したことを示します。
waitlisted (非推奨)	ユーザーがこのクラウド PC への接続を要求し、すべての共有使用ライセンスがアクティブに使用された後、シフト作業クラウド PC が待機リスト状態であることを示します。この値は非推奨であり、2023 年 5 月 17 日に戻りを停止します。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
standbyMode	シフト作業クラウド PC がシャットダウンおよび割り当て解除される前にスタンバイ状態であることを示します。シフトワークスタンバイ状態のクラウド PC には引き続きユーザーがアクセスできます。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.cloudPC",
  "aadDeviceId": "String",
  "allotmentDisplayName": "String",
  "connectivityResult": "String",
  "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"
}