cloudPcProvisioningPolicy リソースの種類
名前空間: 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 で更新します。 |
プロパティ
プロパティ | 型 | 説明 |
---|---|---|
alternateResourceUrl | String | このプロビジョニング ポリシーにリンクする代替リソースの URL。 読み取り専用です。 |
autopatch | cloudPcProvisioningPolicyAutopatch | お客様がクラウド PC で体験できるようにする Windows Autopatch の特定の設定。 この設定は、テナントが Windows Autopatch に登録され、microsoftManagedDesktop プロパティの managedType がstarterManaged として設定されている場合に有効になります。
$select をサポートします。 |
cloudPcGroupDisplayName | String | クラウド PC が存在するクラウド PC グループの表示名。 読み取り専用です。 |
cloudPcNamingTemplate | String | このポリシーを使用してプロビジョニングされたクラウド PC の名前を付けるために使用されるテンプレート。 テンプレートには、ユーザーの名前とランダムに生成された番号をそれぞれ表す %USERNAME:x% と %RAND:x% を含む、カスタムテキストトークンと置換トークンを含めることができます。 たとえば、 CPC-%USERNAME:4%-%RAND:5% は、クラウド PC の名前が CPC- で始まり、次に 4 文字のユーザー名、 - 文字、5 文字のランダム文字が続きます。 テンプレートによって生成されるテキストの長さの合計は、15 文字を超えることはできません。
$filter 、$select 、および $orderby をサポートします。 |
説明 | String | プロビジョニング ポリシーの説明。
$filter 、$select 、および $orderBy をサポートします。 |
displayName | String | プロビジョニング ポリシーの表示名。 |
domainJoinConfigurations | cloudPcDomainJoinConfiguration コレクション | クラウド PC が Microsoft Entra ID (Azure AD) に参加する方法の優先順位で並べ替えられたリストを指定します。
$select をサポートします。 |
enableSingleSignOn | ブール型 |
True シングル サインオンがプロビジョニングされたクラウド PC にアクセスできる場合。
False は、プロビジョニングされたクラウド PC がこの機能をサポートしていないことを示します。 既定値は false です。 Windows 365 ユーザーは、シングル サインオンを使用して、クラウド PC にアクセスするためのパスワードレス オプション (FIDO キーなど) を使用して Microsoft Entra ID に対する認証を行うことができます。 省略可能。 |
gracePeriodInHours | Int32 | 再プロビジョニング/プロビジョニング解除が行われるまでの待機時間。 読み取り専用です。 |
id | String | プロビジョニング ポリシーに関連付けられている一意の識別子。 この ID は、新しいプロビジョニング ポリシーの作成時に自動的に設定されます。 読み取り専用です。
$filter 、$select 、および $orderBy をサポートします。 |
imageDisplayName | String | プロビジョニングに使用されるオペレーティング システム イメージの表示名。 たとえば、「 Windows 11 Preview + Microsoft 365 Apps 23H2 23H2 」のように入力します。
$filter 、$select 、および $orderBy をサポートします。 |
imageId | String | 新しいクラウド PC のプロビジョニングに使用されるオペレーティング システム イメージを表す一意の識別子。 ギャラリーの種類のイメージの形式は、{publisherName_offerName_skuName}です。 各パラメーターでサポートされる値は次のとおりです。
$filter 、$select 、および $orderBy をサポートします。 |
imageType | cloudPcProvisioningPolicyImageType | クラウド PC でのプロビジョニングに使用されるオペレーティング システム イメージ (カスタムまたはギャラリー) の種類。 可能な値は、gallery 、custom です。 既定値は gallery です。 $filter、$select、および$orderByをサポートします。 |
localAdminEnabled | ブール型 |
true すると、ローカル管理者はクラウド PC に対して有効になります。false は、ローカル管理者がクラウド PC に対して有効になっていないことを示します。 既定値は false です。
$filter 、$select 、および $orderBy をサポートします。 |
managedBy | cloudPcManagementService | プロビジョニング ポリシーを管理するサービスを示します。 使用可能な値: windows365 、devBox 、unknownFutureValue 、rpaBox 。 既定値は 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 です。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から次の値を取得する必要があります:sharedByUser 、sharedByEntraGroup 。
shared メンバーは非推奨となり、2027 年 4 月 30 日に戻りを停止します。今後は、sharedByUser メンバーを使用します。 たとえば、 dedicated サービス プランは 1 人のユーザーにのみ割り当てることができ、1 つのクラウド PC のみをプロビジョニングできます。
shared プランとsharedByUser プランでは、お客様が共有サービス プランを購入する必要があります。 購入した各共有ライセンスでは、最大 3 台のクラウド PC を有効にでき、一度にサインインするユーザーは 1 人だけです。
sharedByEntraGroup プランでは、共有サービス プランの購入も必要です。 このプランの各共有ライセンスは、このポリシーの割り当てに従ってグループで共有される 1 つのクラウド PC を有効にすることができます。 既定では、cloudPcProvisioningPolicy の作成時に provisioningType が指定されていない場合、ライセンスの種類はdedicated されます。
cloudPcProvisioningPolicy が作成された後、このプロパティを変更することはできません。 |
windowsSetting | cloudPcWindowsSettings | このプロビジョニング ポリシーのクラウド PC の作成時に構成する特定の Windows 設定を示します。
$select をサポートします。 |
domainJoinConfiguration (非推奨) | cloudPcDomainJoinConfiguration | クラウド PC が Microsoft Entra ID に参加する方法を指定します。 domainJoinConfiguration プロパティは非推奨となり、2024 年 5 月 31 日にデータの返しを停止します。 今後は、 domainJoinConfigurations プロパティを 使用します。 |
onPremisesConnectionId (非推奨) | String | 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
。
メンバー | 説明 |
---|---|
専用 | クラウド 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 の数によって制限されます。 |
リレーションシップ
リレーションシップ | 型 | 説明 |
---|---|---|
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"},
"cloudPcGroupDisplayName": "String",
"cloudPcNamingTemplate": "String",
"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",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {
"@odata.type": "microsoft.graph.microsoftManagedDesktop"
},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"windowsSetting": {
"@odata.type": "microsoft.graph.cloudPcWindowsSetting"
},
"windowsSettings": {
"@odata.type": "microsoft.graph.cloudPcWindowsSettings"
}
}