cloudPcProvisioningPolicy を更新する

名前空間: microsoft.graph

重要

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

cloudPcProvisioningPolicy オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) CloudPC.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション CloudPC.ReadWrite.All 注意事項なし。

HTTP 要求

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文には、 cloudPcProvisioningPolicy オブジェクトの JSON 表現を指定します。

次の表に、 cloudPcProvisioningPolicy で更新できるプロパティを示します。

プロパティ 説明
Autopatch cloudPcProvisioningPolicyAutopatch このプロビジョニング ポリシーを使用するクラウド PC の Windows Autopatch 設定を示します。 この設定は、テナントが自動パッチに登録し、microsoftManagedDesktop プロパティの managedTypestarterManaged に設定されたときに有効になります。 Autopatch を使用してプロビジョニング ポリシーを更新する場合、代理トークンを使用する必要があり、サインイン ユーザーには Intune 管理者ロールが必要です。
autopilotConfiguration cloudPcAutopilotConfiguration Windows 365 のお客様がクラウド PC でエクスペリエンスを実行できるようにする、Windows 365 の特定の設定。 autopilotConfiguration を更新するには、この API のアクセス許可セクションに記載されているアクセス許可が必要です。 委任されたシナリオでは、サインイン ユーザーに Microsoft.Intune/DeviceConfigurations/Assign Intune RBAC アクセス許可も必要です。
説明 String プロビジョニング ポリシーの説明。
displayName 文字列 プロビジョニング ポリシーの表示名。
domainJoinConfigurations cloudPcDomainJoinConfiguration コレクション クラウド PC が Microsoft Entra ID に参加する方法について、優先順位順に並べられた一覧を指定します。
enableSingleSignOn ブール型 True プロビジョニングされたクラウド PC にシングル サインオンでアクセスできる場合。 False プロビジョニングされたクラウド PC がこの機能をサポートしていないことを示します。 既定値は、false です。 Windows 365 ユーザーはシングル サインオンを使用し、パスワードなしのオプション (FIDO キーなど) を使用して Microsoft Entra ID で認証し、クラウド PC にアクセスできます。 省略可能。
imageDisplayName 文字列 プロビジョニングする OS イメージの表示名。
imageId 文字列 クラウド PC でプロビジョニングする OS イメージの ID。 ギャラリー タイプの画像の形式は {publisher_offer_sku} です。 各パラメーターでサポートされている値は以下のとおりです。
  • 発行元: Microsoftwindowsdesktop。
  • オファー: windows-ent-cpc
  • SKU: 21H1-Ent-CPC-M365、21H1-Ent-CPC-OS、20H2-Ent-CPC-M365、20H2-Ent-CPC-OS、20H1-Ent-CPC-M365、20H1-Ent-CPC-OS、19H2-Ent-CPC-M365、19H2-Ent-CPC-OS。
imageType cloudPcProvisioningPolicyImageType クラウド PC でプロビジョニングする OS イメージの種類 (カスタムまたはギャラリー)。 可能な値は gallerycustom です。
microsoftManagedDesktop microsoftManagedDesktop Microsoft マネージド デスクトップのお客様がクラウド PC のデバイス管理エクスペリエンスを取得できるようにする microsoftManagedDesktop の特定の設定。 microsoftManagedDesktop がより多くの価値を提供できるようにするには、管理者が特定の設定を指定する必要があります。
snapshotResetMode cloudPcSnapshotResetMode このプロビジョニング ポリシーでスナップショット リセットを使用できるかどうかを示します。 使用可能な値: notApplicableenableddisabledunknownFutureValue。 既定値は notApplicable です。
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 プロパティを使用します。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "displayName": "HR provisioning policy",
  "description": "Provisioning policy for India HR employees",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "imageId": "Image ID value",
  "imageDisplayName": "Image Display Name value",
  "imageType": "custom",
  "windowsSettings": {
    "language": "en-US"
  },
  "windowsSetting": {
    "locale": "en-US"
  },
  "microsoftManagedDesktop": {
    "managedType": "starterManaged",
    "profile": null
  },
  "autopatch": {
    "autopatchGroupId": "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
  },
  "autopilotConfiguration": {
    "devicePreparationProfileId": "59e5d3d2-ec68-4bfe-9693-27975b318990",
    "applicationTimeoutInMinutes": 30,
    "onFailureDeviceAccessDenied": false
  },
  "userSettingsPersistenceConfiguration": {
    "userSettingsPersistenceEnabled": false,
    "userSettingsPersistenceStorageSizeCategory": "fourGB"
  }
}

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content