CloudPCPROVISIONINGPOLICY: schedulePolicyApplyTask

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.

Legen Sie eine geplante Aufgabe für die automatische erneute Bereitstellung auf die automatische regelmäßige Anwendung fest. Frontline shared berechnet. Nur Administratoren.

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}/schedulePolicyApplyTask

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 des cloudpcpolicyscheduledapplyactiondetail-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die beim Planen einer Aufgabe zum Anwenden von Richtlinien angegeben werden können.

Parameter Typ Beschreibung
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 neu bereitgestellt, wenn keine aktiven und verbundenen Cloud-PC-Benutzer vorhanden sind.
cronScheduleExpression Zeichenfolge Administratoren können einen Cron-Ausdruck festlegen, um die Planungsregeln für die automatische regelmäßige Anwendung zu definieren. Wenn die automatische Bereitstellung deaktiviert ist, auf NULL festgelegt ist, wird die automatische Aufgabenplanung beendet (z. B. "0 0 0 20 * *" bedeutet, dass ein Auftrag so geplant wird, cronScheduleExpression dass er am 20. eines jeden Monats um Mitternacht ausgeführt wird). Schreibgeschützt.
startDateTime Zeichenfolge Gibt an, dass IT-Administratoren ein Startdatum festlegen können, um die erste Schedulerausführung nach diesem Zeitpunkt zu definieren. Wenn nicht festgelegt, ist der Standardwert die aktuelle Zeit. Zu diesem Zeitpunkt gibt es keine Zeitzoneninformationen, sie müssen mit timezonekoordiniert werden, z. B. "2025-01-01 00:00:00" mit "China Standard Time" bedeutet, dass die Planungsregel nach dem 01. Januar 2025 00:00:00 GMT+0800 (China Standard Time) wirksam wird.
endDateTime Zeichenfolge Gibt an, dass IT-Administratoren ein Enddatum festlegen können, um die letzte Planerausführung vor diesem Zeitpunkt zu definieren. Wenn diese Option nicht festgelegt ist, wird der Scheduler kontinuierlich ausgeführt. Zu diesem Zeitpunkt gibt es keine Zeitzoneninformationen, sie müssen mit timezonekoordiniert werden, z. B. "2025-02-01 00:00:00" mit "China Standard Time" bedeutet, dass die Planungsregel vor dem 01. Februar 2025 00:00:00 GMT+0800 (China Standard Time) wirksam wird.
Zeitzone cloudPcPolicyTimezone Gibt an, dass IT-Administratoren eine Zeitzone festlegen können, um die Zeitzone von nextRunDateTime, startDateTime, endDateTime, standardmäßig ist gmt. Mögliche Werte sind gmt, , , nuthst, linteastpstmstmitpktistgetbstcatfjtcettotastestnstartakstazotgsteatacstpgtsbtthacstjstund , ,unknownFutureValuebit

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 ACCEPTED zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/b0c2d35f-3385-46c8-a6f5-6c3dfad7708b/schedulePolicyApplyTask

{
  "reservePercentage": 50,
  "cronScheduleExpression": "0 0 0 20 * *",
  "startDateTime": "2025-03-12 00:00:00",
  "endDateTime": null,
  "timezone": "cst"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content