名前空間: microsoft.graph
特定の クラウド PC を再プロビジョニングします。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | CloudPC.ReadWrite.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | CloudPC.ReadWrite.All | 注意事項なし。 |
HTTP 要求
委任されたアクセス許可を使用して、organizationで指定されたユーザー (サインインしているユーザー) の cloudPC を再プロビジョニングするには、
POST /me/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/reprovision
委任されたアクセス許可 (サインインしているユーザーが管理者である必要があります) またはアプリケーションのアクセス許可を使用して、organizationで指定した cloudPC を再プロビジョニングするには、
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
注: 管理者 サポート要求本文の API のみ。
要求本文で、パラメーターの JSON 表現を指定します。
次の表に、このアクションで使用できるパラメーターを示します。
| パラメーター | 型 | 説明 |
|---|---|---|
| osVersion | cloudPcOperatingSystem | クラウド PC でプロビジョニングするオペレーティング システム (OS) のバージョン。 使用可能な値は、 windows10、 windows11、および unknownFutureValueです。 |
| userAccountType | cloudPcUserAccountType | プロビジョニングされたクラウド PC 上のユーザーのアカウントの種類。 使用可能な値は、 standardUser、 administrator、および unknownFutureValueです。 |
cloudPcOperatingSystem の値
| メンバー | 説明 |
|---|---|
| windows10 | Windows 10 オペレーティング システム。 |
| windows11 | Windows 11 オペレーティング システム。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcUserAccountType 値
| メンバー | 説明 |
|---|---|
| standardUser | クラウド PC に対するローカルの管理者権限を持たないユーザー。 Standardユーザーは Microsoft Store アプリからのコンテンツのみをインストールできますが、ローカル管理者権限を必要とする Windows 設定を変更することはできません。 |
| 管理者 | クラウド PC に対する完全なローカル管理アクセス許可を持つユーザー。 管理者は、任意のソフトウェアをインストールし、クラウド PC 上の任意のファイルまたは設定を変更できます。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。
例
例 1: 管理者用に cloudPC を再プロビジョニングする
次の例は、管理者用にクラウド PC を再プロビジョニングする方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/reprovision
Content-Type: application/json
Content-length: 61
{
"userAccountType": "administrator",
"osVersion": "windows10"
}
応答
HTTP/1.1 204 No Content
次の例は、サインインしているユーザー用にクラウド PC を再プロビジョニングする方法を示しています。
例 2: サインインしているユーザーの cloudPC を再プロビジョニングする
次の例は、サインインしているユーザー用にクラウド PC を再プロビジョニングする方法を示しています。
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content