cloudPcProvisioningPolicy: apply

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Wenden Sie die aktuelle Konfiguration der Bereitstellungsrichtlinie auf alle Cloud-PC-Geräte unter einer angegebenen Richtlinie an. Sie können Richtlinieneinstellungen wie region und singleSignOnanwenden. Diese Aktion unterstützt auch die erneute Bereitstellung für Cloud-PCs im gemeinsamen Modus in Frontline, indem der Parameter reservePercentage verwendet wird, um den Prozentsatz der Cloud-PCs zu steuern, die während des Prozesses verfügbar bleiben.

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

POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/apply

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Parameter aufgeführt, die Sie mit dieser Methode verwenden können.

Parameter Typ Beschreibung
policySettings cloudPcPolicySettingType Die Zieleigenschaft der Apply-Aktion. Die möglichen Werte sind: region, singleSignOn, unknownFutureValue. Der Standardwert ist region. Diese Aktion gilt region als Wert, wenn dieser Parameter ist null.
reservePercentage Int32 Nur für Frontline shared . Der Prozentsatz der Cloud-PCs, die verfügbar bleiben sollen. Administratoren können diese Eigenschaft auf einen Wert von 0 bis 99 festlegen. Cloud-PCs werden nur dann erneut bereitgestellt, wenn keine aktiven und verbundenen Cloud-PC-Benutzer vorhanden sind.

Antwort

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

Beispiele

Beispiel 1: Anwenden einer Richtlinieneinstellung auf Cloud-PCs

Das folgende Beispiel zeigt, wie Eine Richtlinieneinstellung wie region auf alle Cloud-PC-Geräte unter einer angegebenen Bereitstellungsrichtlinie angewendet wird.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "policySettings": "region"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Erneutes Bereitstellen von gemeinsam genutzten Cloud-PCs in Frontline mit einem Reserveprozentsatz

Das folgende Beispiel zeigt, wie Sie gemeinsam genutzte Cloud-PCs in Frontline unter einer angegebenen Bereitstellungsrichtlinie erneut bereitstellen und 80 % der Cloud-PCs verfügbar halten.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "reservePercentage": 80
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content
  • Last updated on