名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド PC プロビジョニング ポリシーを表します。
メソッド
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| alternateResourceUrl | 文字列 | このプロビジョニング ポリシーにリンクする代替リソースの URL。 読み取り専用です。 |
| Autopatch | cloudPcProvisioningPolicyAutopatch | このプロビジョニング ポリシーを使用するクラウド PC の Windows Autopatch 設定を示します。 この設定は、テナントが自動パッチに登録し、microsoftManagedDesktop プロパティの managedType が starterManaged に設定されたときに有効になります。
自動パッチを使用してプロビジョニング ポリシーを作成または更新する場合は、委任トークンを使用する必要があり、サインイン ユーザーには Intune 管理者ロールが必要です。
$select をサポートします。 |
| autopilotConfiguration | cloudPcAutopilotConfiguration | Windows 365 のお客様がクラウド PC でエクスペリエンスを実行できるようにする、Windows 365 の特定の設定。
autopilotConfiguration を使用してプロビジョニング ポリシーを作成または更新する場合は、対応する API の作成ページと更新 API ページに一覧表示されている必要な Microsoft Graph アクセス許可を使用します。 委任されたシナリオでは、サインイン ユーザーに Microsoft.Intune/DeviceConfigurations/Assign Intune RBAC アクセス許可も必要です。
$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 キーなど) を使用して Microsoft Entra ID で認証し、クラウド PC にアクセスできます。 省略可能。 |
| 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 マネージド デスクトップのお客様がクラウド 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 の作成後にこのプロパティを変更することはできません。 |
| scopeIds | String collection | このリソースのスコープ タグ ID の一覧。 読み取り専用です。 |
| snapshotResetMode | cloudPcSnapshotResetMode | このプロビジョニング ポリシーでスナップショット リセットを使用できるかどうかを示します。 使用可能な値: notApplicable、enabled、disabled、unknownFutureValue。 既定値は notApplicable です。 |
| userExperienceType | cloudPcUserExperienceType | エンド ユーザーがアクセスできるクラウド オブジェクトの種類を指定します。 使用可能な値: cloudPc、cloudApp、unknownFutureValue。
cloudPc エンド ユーザーがデスクトップ全体にアクセスできることを示します。
cloudApp エンド ユーザーがこのプロビジョニング ポリシーに基づいて公開されたアプリにのみアクセスできることを示します。 プロビジョニング ポリシーが作成されると、種類は変更できません。 作成時に指定しない場合、既定値は cloudPc です。
cloudAppが選択されている場合は、provisioningType をsharedByEntraGroupする必要があります。
$filter、$select、$orderBy をサポートしています。 |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | クラウド PC セッション間でユーザー アプリケーション設定を永続化できるようにする特定の設定を示します。 既定値は null です。 この機能は、種類 sharedByEntraGroup のクラウド PC プロビジョニング ポリシーでのみ使用できます。
$select をサポートします。 |
| windowsSetting | cloudPcWindowsSettings | このプロビジョニング ポリシーのクラウド PC の作成中に構成する特定の Windows 設定を示します。
$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 のプロビジョニングに専用ライセンスを使用することを示します。 既定値です。 |
| 共有 (非推奨) | クラウド 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 時間の使用時間を取得できます。 |
cloudPcSnapshotResetMode 値
| メンバー | 説明 |
|---|---|
| notApplicable | スナップショットのリセットがプロビジョニング ポリシーに適用されないことを示します。 |
| enabled | プロビジョニング ポリシーでスナップショットのリセットが有効になっていることを示します。 |
| disabled | プロビジョニング ポリシーでスナップショットのリセットが無効になっていることを示します。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcUserExperienceType 値
| メンバー | 説明 |
|---|---|
| cloudPc | エンド ユーザーがデスクトップ全体にアクセスできることを示します。 |
| cloudApp | エンド ユーザーがこのプロビジョニング ポリシーに基づいて公開されたクラウド アプリにのみアクセスできることを示します。 |
| 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",
"scopeIds": ["String"],
"snapshotResetMode": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}