cloudPcProvisioningPolicy リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド PC プロビジョニング ポリシーを表します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| provisioningPolicies を一覧表示する | cloudPcProvisioningPolicy コレクション | cloudPcProvisioningPolicy オブジェクトのプロパティとリレーションシップを一覧表示します。 |
| cloudPcProvisioningPolicy を取得する | cloudPcProvisioningPolicy | cloudPcProvisioningPolicy オブジェクトのプロパティとリレーションシップを読み取ります。 |
| cloudPcProvisioningPolicy のCreate | cloudPcProvisioningPolicy | 新しい cloudPcProvisioningPolicy オブジェクトをCreateします。 |
| cloudPcProvisioningPolicy を更新する | cloudPcProvisioningPolicy | cloudPcProvisioningPolicy オブジェクトのプロパティを更新します。 |
| cloudPcProvisioningPolicy を削除する | なし | cloudPcProvisioningPolicy オブジェクトを削除します。 |
| cloudPcProvisioningPolicy の割り当て | なし | cloudPcProvisioningPolicy をユーザー グループに割り当てます。 |
| cloudPcProvisioningPolicy を適用する | なし | 指定したポリシーの下にあるすべてのクラウド PC デバイスに、現在の プロビジョニング ポリシー構成を適用します。 現時点では、リージョンのみを変更できます。 |
| applyConfig | なし | 一連のクラウド PC デバイスの プロビジョニング ポリシー 構成を ID で更新します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| alternateResourceUrl | String | このプロビジョニング ポリシーにリンクする代替リソースの URL。 読み取り専用です。 |
| cloudPcGroupDisplayName | String | クラウド PC が存在するクラウド PC グループの表示名。 読み取り専用です。 |
| cloudPcNamingTemplate | String | このポリシーを使用してプロビジョニングされたクラウド PC の名前を付けるために使用されるテンプレート。 テンプレートには、ユーザーの名前とランダムに生成された番号をそれぞれ表す、および %RAND:x%を含む%USERNAME:x%カスタム テキストトークンと置換トークンを含めることができます。 たとえば、 CPC-%USERNAME:4%-%RAND:5% クラウド PC の名前は で CPC-始まり、その後に 4 文字のユーザー名、1 - 文字、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ユーザーは、シングル サインオンを使用して、パスワードレス オプション (FIDO キーなど) を使用してクラウド PC にアクセスする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この進化可能な列挙型から次の値を取得する必要があります。 sharedByUsersharedByEntraGroup メンバーは shared 非推奨であり、2027 年 4 月 30 日に戻りを停止します。今後、メンバーを使用します sharedByUser 。 たとえば、1 つのサービス プランを dedicated 1 人のユーザーにのみ割り当て、1 つのクラウド PC のみをプロビジョニングできます。 プランと sharedByUser プランではshared、顧客が共有サービス プランを購入する必要があります。 購入した各共有ライセンスでは、最大 3 台のクラウド PC を有効にでき、一度にサインインするユーザーは 1 人だけです。 このプランでは sharedByEntraGroup 、共有サービス プランの購入も必要です。 このプランの各共有ライセンスは、このポリシーの割り当てに従ってグループで共有される 1 つのクラウド PC を有効にすることができます。 既定では、ライセンスの種類はdedicated、cloudPcProvisioningPolicy の作成時に provisioningType が指定されていない場合です。 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この進化可能な列挙型の次の値を取得する必要があります。 sharedByUsersharedByEntraGroup
| メンバー | 説明 |
|---|---|
| 専用 | クラウド 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",
"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"
}
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示