名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド PC プロビジョニング ポリシーを表します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | cloudPcProvisioningPolicy コレクション | cloudPcProvisioningPolicy オブジェクトのプロパティとリレーションシップを一覧表示します。 |
| Get | cloudPcProvisioningPolicy | cloudPcProvisioningPolicy オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Create | cloudPcProvisioningPolicy | 新しい cloudPcProvisioningPolicy オブジェクトを 作成します。 |
| Update | cloudPcProvisioningPolicy | cloudPcProvisioningPolicy オブジェクトのプロパティを更新します。 |
| Delete | なし | cloudPcProvisioningPolicy オブジェクトを削除します。 |
| Assign | なし | cloudPcProvisioningPolicy をユーザー グループに割り当てます。 |
| Apply | なし | 指定したポリシーの下にあるすべてのクラウド PC デバイスに、現在の プロビジョニング ポリシー構成を適用します。 現時点では、リージョンのみを変更できます。 |
| 構成の適用 | なし | 一連のクラウド PC デバイスの プロビジョニング ポリシー 構成を ID で更新します。 |
| 再試行 | なし | 現在の現場共有ポリシーを使用し、プロビジョニング ポリシーの適用に失敗したクラウド PC のプロビジョニング操作を再試行 します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| alternateResourceUrl | 文字列 | このプロビジョニング ポリシーにリンクする代替リソースの URL。 読み取り専用です。 |
| オートパッチ | cloudPcProvisioningPolicyAutopatch | このプロビジョニング ポリシーを使用するクラウド PC の Windows Autopatch 設定を示します。 この設定は、テナントが Autopatch に登録され、microsoftManagedDesktop プロパティの managedType がstarterManagedとして設定されている場合に有効になります。
$select をサポートします。 |
| autopilotConfiguration | cloudPcAutopilotConfiguration | Windows 365のお客様がクラウド PC で体験できるようにする Windows Autopilot の特定の設定。
$select をサポートします。 |
| cloudPcGroupDisplayName | 文字列 | クラウド PC が存在するクラウド PC グループの表示名。 読み取り専用です。 |
| cloudPcNamingTemplate | 文字列 | このポリシーを使用してプロビジョニングされたクラウド PC の名前を付けるために使用されるテンプレート。 テンプレートには、ユーザーの名前とランダムに生成された番号をそれぞれ表す %USERNAME:x% と %RAND:x%を含む、カスタムテキストトークンと置換トークンを含めることができます。 たとえば、 CPC-%USERNAME:4%-%RAND:5% は、クラウド PC の名前が CPC- で始まり、次に 4 文字のユーザー名、 - 文字、5 文字のランダム文字が続きます。 テンプレートによって生成されるテキストの長さの合計は、15 文字を超えることはできません。
$filter、$select、および $orderby をサポートします。 |
| createdBy | String | このポリシーを作成したユーザーの一意の ID。 たとえば、「 5ccb8d35-dd04-473e-a287-69bb4473208b 」のように入力します。 読み取り専用です。
$select をサポートしています。 |
| createdDateTime | DateTimeOffset | このプロビジョニング ポリシーが作成されたときのタイムスタンプ。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。
$select と $orderBy をサポートします。 |
| 説明 | String | プロビジョニング ポリシーの説明。
$filter、$select、および $orderBy をサポートします。 |
| displayName | 文字列 | プロビジョニング ポリシーの表示名。 |
| domainJoinConfigurations | cloudPcDomainJoinConfiguration コレクション | クラウド PC の参加Microsoft Entra ID (Azure AD) の優先順位で並べ替えられたリストを指定します。
$select をサポートします。 |
| enableSingleSignOn | ブール型 |
True シングル サインオンがプロビジョニングされたクラウド PC にアクセスできる場合。
False は、プロビジョニングされたクラウド PC がこの機能をサポートしていないことを示します。 既定値は false です。 Windows 365ユーザーは、シングル サインオンを使用して、パスワードレス オプション (FIDO キーなど) を使用してクラウド PC にアクセスするMicrosoft Entra IDを認証できます。 省略可能。 |
| gracePeriodInHours | Int32 | 再プロビジョニング/プロビジョニング解除が行われるまでの待機時間。 読み取り専用です。 |
| id | 文字列 | プロビジョニング ポリシーに関連付けられている一意の識別子。 この ID は、新しいプロビジョニング ポリシーの作成時に自動的に設定されます。 読み取り専用です。
$filter、$select、および $orderBy をサポートします。 |
| imageDisplayName | 文字列 | プロビジョニングに使用されるオペレーティング システム イメージの表示名。 たとえば、「 Windows 11 Preview + Microsoft 365 Apps 23H2 23H2 」のように入力します。
$filter、$select、および $orderBy をサポートします。 |
| imageId | 文字列 | 新しいクラウド PC のプロビジョニングに使用されるオペレーティング システム イメージを表す一意の識別子。 ギャラリーの種類のイメージの形式は、{publisherName_offerName_skuName}です。 各パラメーターでサポートされる値は次のとおりです。
$filter、$select、および $orderBy をサポートします。 |
| imageType | cloudPcProvisioningPolicyImageType | クラウド PC でのプロビジョニングに使用されるオペレーティング システム イメージ (カスタムまたはギャラリー) の種類。 使用可能な値は、 gallery、 customです。 既定値は gallery です。 $filter、$select、および$orderByをサポートします。 |
| lastModifiedBy | 文字列 | このポリシーを最後に更新したユーザーの一意の ID。 たとえば、「 5ccb8d35-dd04-473e-a287-69bb4473208b 」のように入力します。 読み取り専用です。
$select をサポートします。 |
| lastModifiedDateTime | DateTimeOffset | このプロビジョニング ポリシーが最後に変更されたときのタイムスタンプ。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。
$select と $orderBy をサポートします。 |
| localAdminEnabled | ブール型 |
trueすると、ローカル管理者はクラウド PC に対して有効になります。falseは、ローカル管理者がクラウド PC に対して有効になっていないことを示します。 既定値は false です。
$filter、$select、および $orderBy をサポートします。 |
| managedBy | cloudPcManagementService | プロビジョニング ポリシーを管理するサービスを示します。 使用可能な値: windows365、devBox、unknownFutureValue、rpaBox、microsoft365Opal、microsoft365BizChat。 既定値は windows365 です。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型の次のメンバーを取得します:rpaBox。
$filter、$select、および $orderBy をサポートします。 |
| microsoftManagedDesktop | microsoftManagedDesktop | Microsoft Managed Desktop のお客様がクラウド PC のデバイス管理エクスペリエンスを取得できるようにする microsoftManagedDesktop の特定の設定。
microsoftManagedDesktop がより多くの値を提供できるようにするには、管理者がそれに特定の設定を指定する必要があります。
$filter、$select、および $orderBy をサポートします。 |
| provisioningType | cloudPcProvisioningType | このポリシーを使用してクラウド PC をプロビジョニングするときに使用するライセンスの種類を指定します。 使用できる値は、 dedicated、 shared、 unknownFutureValue、 sharedByUser、 sharedByEntraGroup、 reserveです。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得します:sharedByUser、sharedByEntraGroup、reserve。
shared メンバーは非推奨となり、2027 年 4 月 30 日に戻りを停止します。今後は、sharedByUser メンバーを使用します。 たとえば、 dedicated サービス プランは 1 人のユーザーにのみ割り当てることができ、1 つのクラウド PC のみをプロビジョニングできます。
sharedプランとsharedByUserプランでは、お客様が共有サービス プランを購入する必要があります。 購入した各共有ライセンスでは、最大 3 台のクラウド PC を有効にでき、一度にサインインするユーザーは 1 人だけです。
sharedByEntraGroup プランでは、共有サービス プランの購入も必要です。 このプランの各共有ライセンスは、このポリシーの割り当てに従ってグループで共有される 1 つのクラウド PC を有効にすることができます。 既定では、cloudPcProvisioningPolicy の作成時に provisioningType が指定されていない場合、ライセンスの種類はdedicatedされます。
cloudPcProvisioningPolicy が作成された後、このプロパティを変更することはできません。 |
| userExperienceType | cloudPcUserExperienceType | エンド ユーザーがアクセスできるクラウド オブジェクトの種類を指定します。 使用可能な値: cloudPc、cloudApp、unknownFutureValue。
cloudPc は、エンド ユーザーがデスクトップ全体にアクセスできることを示します。
cloudApp は、エンド ユーザーがこのプロビジョニング ポリシーで発行されたアプリにのみアクセスできることを示します。 プロビジョニング ポリシーが作成されたら、型を変更することはできません。 作成時に指定しない場合、既定値は cloudPc。
cloudAppが選択されている場合は、provisioningType をsharedByEntraGroupする必要があります。
$filter、$select、$orderByをサポートします。 |
| windowsSetting | cloudPcWindowsSettings | このプロビジョニング ポリシーのクラウド PC の作成時に構成する特定の Windows 設定を示します。
$select をサポートします。 |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | クラウド PC セッション間のユーザー アプリケーション設定の永続化を有効にする特定の設定を示します。 既定値は null です。 この機能は、種類が sharedByEntraGroupのクラウド PC プロビジョニング ポリシーでのみ使用できます。
$select をサポートします。 |
| domainJoinConfiguration (非推奨) | cloudPcDomainJoinConfiguration | クラウド PC がMicrosoft Entra IDに参加する方法を指定します。 domainJoinConfiguration プロパティは非推奨となり、2024 年 5 月 31 日にデータの返しを停止します。 今後は、 domainJoinConfigurations プロパティを 使用します。 |
| onPremisesConnectionId (非推奨) | 文字列 | cloudPcOnPremisesConnection の ID。 クラウド PC にネットワーク接続があり、ドメインに参加していることを確認するには、クラウド PC サービスが検証した仮想ネットワークとの接続を選択します。 onPremisesConnectionId プロパティは非推奨となり、2024 年 5 月 31 日にデータの返しを停止します。 今後は、 domainJoinConfigurations プロパティを 使用します。 |
| windowsSettings (非推奨) | cloudPcWindowsSettings | このプロビジョニング ポリシーのクラウド PC の作成時に構成する特定の Windows 設定。
$select をサポートします。
windowsSettings プロパティは非推奨となり、2024 年 1 月 31 日にデータの返しを停止します。 今後は、 windowsSetting プロパティを使用します。 |
cloudPcProvisioningType 値
次の表に、 進化可能な列挙体のメンバーを示します。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得します。sharedByUser、sharedByEntraGroup、reserve。
| メンバー | 説明 |
|---|---|
| 専用 | クラウド PC のプロビジョニングに専用ライセンスが使用されることを示します。 既定値です。 |
| shared (非推奨) | クラウド PC のプロビジョニングに共有ライセンスが使用されることを示します。
shared メンバーは非推奨となり、2027 年 4 月 30 日に復帰を停止します。 今後は、 sharedByUser メンバーを使用します。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
| sharedByUser | 割り当てグループ内の各ユーザーに対して専用のクラウド PC がプロビジョニングされる場合のプロビジョニング ポリシーを示します。 ユーザーは常に同じクラウド PC に接続されます。 ただし、クラウド PC の可用性は、アクティブなセッションの合計数によって制限されます。 |
| sharedByEntraGroup | Microsoft Entra (Azure AD) グループによって共有されるクラウド PC に関連付けられているプロビジョニング ポリシーを示します。 共有クラウド PC がプロビジョニングされると、Microsoft Entra ID割り当てグループ内の任意のユーザーが接続できるようになります。 ユーザーは接続ごとに異なるクラウド PC に接続できます。可用性は、プロビジョニングされたクラウド PC の数によって制限されます。 |
| 予約 | クラウド PC のプロビジョニング時に、ポリシーで専用のユーザーごとの期限付きライセンスを使用する必要があることを示します。 予約ポリシーを使用するこれらのクラウド PC は、ユーザーがチェックアウトおよびチェックインを複数回行い、クラウド PC がチェックアウトされた後にのみ期限付きライセンスが使用されます。現時点では、各ユーザーは各予約サービス プラン インスタンスから 10 時間の使用時間を取得できます。 |
cloudPcUserExperienceType 値
| メンバー | 説明 |
|---|---|
| cloudPc | エンド ユーザーがデスクトップ全体にアクセスできることを示します。 |
| cloudApp | エンド ユーザーが、このプロビジョニング ポリシーで発行された Cloud Apps にのみアクセスできることを示します。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| assignments | cloudPcProvisioningPolicyAssignment コレクション | プロビジョニング ポリシーの割り当ての定義済みのコレクション。 プロビジョニング ポリシーが割り当てられているMicrosoft Entra IDの Microsoft 365 グループとセキュリティ グループのセットを表します。
$expand でのみ返されます。 割り当て関係を取得する方法の例については、「 Get cloudPcProvisioningPolicy」を参照してください。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
"alternateResourceUrl": "String",
"autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
"autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
"cloudPcGroupDisplayName": "String",
"cloudPcNamingTemplate": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"domainJoinConfiguration": {"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"},
"domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
"enableSingleSignOn": "Boolean",
"gracePeriodInHours": "Int32",
"id": "String (identifier)",
"imageDisplayName": "String",
"imageId": "String",
"imageType": "String",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}