Freigeben über

cloudPC: Erneute Bereitstellung

Namespace: microsoft.graph

Erneutes Bereitstellen eines bestimmten Cloud-PCs.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) CloudPC.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application CloudPC.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

So stellen Sie den cloudPC des angegebenen Benutzers (der der angemeldete Benutzer ist) im organization mit delegierter Berechtigung erneut bereit:

POST /me/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/reprovision

Um den angegebenen cloudPC im organization erneut bereitzustellen, verwenden Sie entweder die delegierte Berechtigung (der angemeldete Benutzer sollte der Administrator sein) oder die Anwendungsberechtigung:

POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Hinweis: Nur der Anforderungstext der APIs für den Administratorsupport .

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Parameter Typ Beschreibung
osVersion cloudPcOperatingSystem Die Version des Betriebssystems, das auf Cloud-PCs bereitgestellt werden soll. Mögliche Werte sind: windows10, windows11und unknownFutureValue.
userAccountType cloudPcUserAccountType Der Kontotyp des Benutzers auf bereitgestellten Cloud-PCs. Mögliche Werte sind: standardUser, administratorund unknownFutureValue.

cloudPcOperatingSystem-Werte

Member Beschreibung
windows10 Das Windows 10 Betriebssystem.
windows11 Das Windows 11 Betriebssystem.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

cloudPcUserAccountType-Werte

Member Beschreibung
standardUser Ein Benutzer ohne lokale Administratorberechtigungen auf dem Cloud-PC. Standard Können Benutzer nur Inhalte aus der Microsoft Store-App installieren, aber sie können keine Windows-Einstellungen ändern, die lokale Administratorrechte erfordern.
Administrator Ein Benutzer mit vollständigen lokalen Administratorberechtigungen auf dem Cloud-PC. Administratoren können jede Beliebige Software installieren und jede Datei oder Einstellung auf dem Cloud-PC ändern.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Erneutes Bereitstellen des cloudPC für den Administrator

Das folgende Beispiel zeigt, wie Sie den Cloud-PC für den Administrator neu bereitstellen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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"
}

Antwort

HTTP/1.1 204 No Content

Das folgende Beispiel zeigt, wie Sie den Cloud-PC für den angemeldeten Benutzer erneut bereitstellen.

Beispiel 2: Erneutes Bereitstellen des cloudPC für den angemeldeten Benutzer

Das folgende Beispiel zeigt, wie Sie den Cloud-PC für den angemeldeten Benutzer erneut bereitstellen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content
  • Last updated on