Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Stellt eine Cloud-PC-Bereitstellungsrichtlinie dar.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | cloudPcProvisioningPolicy-Sammlung | Listen Sie Eigenschaften und Beziehungen der cloudPcProvisioningPolicy-Objekte auf. |
| Get | cloudPcProvisioningPolicy | Lesen Sie die Eigenschaften und Beziehungen eines cloudPcProvisioningPolicy-Objekts . |
| Create | cloudPcProvisioningPolicy | Erstellen Sie ein neues cloudPcProvisioningPolicy-Objekt . |
| Update | cloudPcProvisioningPolicy | Aktualisieren Sie die Eigenschaften eines cloudPcProvisioningPolicy-Objekts . |
| Löschen | Keine | Löschen Sie ein cloudPcProvisioningPolicy-Objekt . |
| Assign | Keine | Weisen Sie Benutzergruppen eine cloudPcProvisioningPolicy zu. |
| Apply | Keine | Wenden Sie die aktuelle Konfiguration der Bereitstellungsrichtlinie auf alle Cloud-PC-Geräte unter einer angegebenen Richtlinie an. |
| Konfiguration anwenden | Keine | Aktualisieren Sie die Bereitstellungsrichtlinienkonfiguration für eine Gruppe von Cloud-PC-Geräten anhand ihrer IDs. |
| Wiederholen | Keine | Wiederholen Sie den Bereitstellungsvorgang für Cloud-PCs, die die aktuelle Richtlinie für gemeinsam genutzte Frontline verwendet haben und die Bereitstellungsrichtlinie nicht angewendet werden konnten. |
| Planungsrichtlinie Wenden Sie eine Aufgabe an | Keine | Planen einer Aufgabe zum Anwenden einer Richtlinie für eine Bereitstellungsrichtlinie. |
| Ergebnis der Richtlinie zum Anwenden der Aktion abrufen | cloudPcPolicyApplyActionResult | Abrufen des Ergebnisses einer Aktion zum Anwenden einer Richtlinie auf eine Bereitstellungsrichtlinie. |
| Zeitplan zum Anwenden von Richtlinien abrufen | cloudPcPolicyScheduledApplyActionDetail | Abrufen des Zeitplans für eine Richtlinie: Anwenden einer Aktion für eine Bereitstellungsrichtlinie. |
| Abrufen des Status der Richtlinienaktualisierung | cloudPcPolicyPendingApplyStatusResult | Rufen Sie den Status einer Bereitstellungsrichtlinie ab, um zu ermitteln, ob nicht übernommene Änderungen für Cloud-PCs vorhanden sind. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| alternateResourceUrl | Zeichenfolge | Die URL der alternativen Ressource, die mit dieser Bereitstellungsrichtlinie verknüpft ist. Schreibgeschützt. |
| Automatisches Patchen | cloudPcProvisioningPolicyAutopatch | Gibt die Windows Autopatch-Einstellungen für Cloud-PCs an, die diese Bereitstellungsrichtlinie verwenden. Die Einstellungen werden wirksam, wenn sich der Mandant bei Autopatch anmeldet und der managedType der microsoftManagedDesktop-Eigenschaft auf starterManagedfestgelegt ist. Wenn Sie eine Bereitstellungsrichtlinie mit Autopatch erstellen oder aktualisieren, müssen Sie ein delegiertes Token verwenden und der angemeldete Benutzer muss die Rolle Intune-Administrator haben. Unterstützt $select. |
| autopilotConfiguration | cloudPcAutopilotConfiguration | Die spezifischen Einstellungen für Windows Autopilot, die es Windows 365-Kunden ermöglichen, es auf Cloud PC zu erleben. Wenn Sie eine Bereitstellungsrichtlinie mit autopilotConfiguration erstellen oder aktualisieren, verwenden Sie die erforderlichen Microsoft Graph-Berechtigungen, die auf den entsprechenden Seiten zum Erstellen und Aktualisieren der API aufgeführt sind. In delegierten Szenarien muss der angemeldete Benutzer auch über die Microsoft.Intune/DeviceConfigurations/Assign Intune RBAC-Berechtigung verfügen. Unterstützt $select. |
| cloudPcGroupDisplayName | Zeichenfolge | Der Anzeigename der Cloud-PC-Gruppe, in der sich die Cloud-PCs befinden. Schreibgeschützt. |
| cloudPcNamingTemplate | Zeichenfolge | Die Vorlage, die zum Benennen von Cloud-PCs verwendet wird, die mit dieser Richtlinie bereitgestellt wurden. Die Vorlage kann benutzerdefinierten Text und Ersatztoken enthalten, einschließlich %USERNAME:x% und %RAND:x%, die jeweils den Namen des Benutzers und eine zufällig generierte Zahl darstellen. Bedeutet beispielsweise CPC-%USERNAME:4%-%RAND:5% , dass der Name des Cloud-PCs mit CPC-beginnt, gefolgt von einem vierstelligen Benutzernamen, einem - Zeichen und dann fünf zufälligen Zeichen. Die Gesamtlänge des von der Vorlage generierten Textes darf 15 Zeichen nicht überschreiten. Unterstützt $filter, $select und $orderby. |
| createdBy | Zeichenfolge | Die eindeutige ID des Benutzers, der diese Richtlinie erstellt hat. Beispiel: 5ccb8d35-dd04-473e-a287-69bb4473208b. Schreibgeschützt. Unterstützt $select. |
| createdDateTime | DateTimeOffset | Der Zeitstempel, als diese Bereitstellungsrichtlinie erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt. Unterstützt $select und $orderBy. |
| description | Zeichenfolge | Die Beschreibung der Bereitstellungsrichtlinie. Unterstützt $filter, $select und $orderBy. |
| displayName | Zeichenfolge | Der Anzeigename für die Bereitstellungsrichtlinie. |
| domainJoinConfigurations | cloudPcDomainJoinConfiguration collection | Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs Microsoft Entra ID (Azure AD) beitreten. Unterstützt $select. |
| enableSingleSignOn | Boolean |
True Single Sign-On auf den bereitgestellten Cloud-PC zugreifen kann.
False gibt an, dass der bereitgestellte Cloud-PC dieses Feature nicht unterstützt. Der Standardwert ist false. Windows 365-Benutzer können das einmalige Anmelden verwenden, um sich bei Microsoft Entra ID mit kennwortlosen Optionen (z. B. FIDO-Schlüsseln) zu authentifizieren, um auf ihren Cloud-PC zuzugreifen. Optional. |
| gracePeriodInHours | Int32 | Die Anzahl der Stunden, die gewartet werden muss, bevor eine erneute Provisionierung/Deprovisionierung erfolgt. Schreibgeschützt. |
| id | Zeichenfolge | Der eindeutige Bezeichner, der der Bereitstellungsrichtlinie zugeordnet ist. Diese ID wird während der Erstellung einer neuen Bereitstellungsrichtlinie automatisch ausgefüllt. Schreibgeschützt. Unterstützt $filter, $select und $orderBy. |
| imageDisplayName | Zeichenfolge | Der Anzeigename des Betriebssystemimage, das für die Bereitstellung verwendet wird. Beispiel: Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Unterstützt $filter, $select und $orderBy. |
| imageId | Zeichenfolge | Der eindeutige Bezeichner, der ein Betriebssystemimage darstellt, das zum Bereitstellen neuer Cloud-PCs verwendet wird. Das Format für ein Katalogbild ist: {publisherName_offerName_skuName}. Unterstützte Werte für jeden der Parameter sind:
$filter, $select und $orderBy. |
| imageType | cloudPcProvisioningPolicyImageType | Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das für die Bereitstellung auf Cloud-PCs verwendet wird. Die möglichen Werte sind: gallery, custom. Der Standardwert ist gallery. Unterstützt $filter, $select und $orderBy. |
| lastModifiedBy | Zeichenfolge | Die eindeutige ID des Benutzers, der diese Richtlinie zuletzt aktualisiert hat. Beispiel: 5ccb8d35-dd04-473e-a287-69bb4473208b. Schreibgeschützt. Unterstützt $select. |
| lastModifiedDateTime | DateTimeOffset | Der Zeitstempel, als diese Bereitstellungsrichtlinie zuletzt geändert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt. Unterstützt $select und $orderBy. |
| localAdminEnabled | Boolean | Wenn trueder lokale Administrator für Cloud-PCs aktiviert ist, false bedeutet dies, dass der lokale Administrator für Cloud-PCs nicht aktiviert ist. Der Standardwert ist false. Unterstützt $filter, $select und $orderBy. |
| managedBy | cloudPcManagementService | Gibt den Dienst an, der die Bereitstellungsrichtlinie verwaltet. Mögliche Werte sind: windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Der Standardwert ist windows365. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Elemente in dieser entwicklungsfähigen Aufzählung abzurufen: rpaBox. Unterstützt $filter, $select und $orderBy. |
| microsoftManagedDesktop | microsoftManagedDesktop | Die spezifischen Einstellungen für microsoftManagedDesktop , die es Microsoft Managed Desktop-Kunden ermöglichen, geräteseitig verwaltete Erfahrungen für Cloud PC zu erhalten. Damit microsoftManagedDesktop mehr Wert bieten kann, muss ein Administrator bestimmte Einstellungen darin angeben. Unterstützt $filter, $select und $orderBy. |
| provisioningType | cloudPcProvisioningType | Gibt die Art der Lizenzen an, die beim Bereitstellen von Cloud-PCs mit dieser Richtlinie verwendet werden sollen. Die möglichen Werte sind dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup, . reserve Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: sharedByUser, sharedByEntraGroup, reserve. Das shared Mitglied ist veraltet und kehrt ab dem 30. April 2027 nicht mehr zurück. Verwenden Sie das sharedByUser Mitglied in Zukunft. Beispielsweise kann ein dedicated Serviceplan nur einem Benutzer zugewiesen werden und nur einen Cloud-PC bereitstellen. Für die shared Pläne und sharedByUser müssen Kunden einen gemeinsamen Dienstplan erwerben. Jede erworbene freigegebene Lizenz kann bis zu drei Cloud-PCs aktivieren, wobei jeweils nur ein Benutzer angemeldet ist. Der sharedByEntraGroup Plan erfordert auch den Kauf eines Shared-Service-Plans. Jede freigegebene Lizenz im Rahmen dieses Plans kann einen Cloud-PC aktivieren, der für die Gruppe gemäß den Zuweisungen dieser Richtlinie gemeinsam genutzt wird. Standardmäßig liegt dedicated der Lizenztyp vor, wenn der Bereitstellungstyp beim Erstellen der cloudPcProvisioningPolicy nicht angegeben wird. Sie können diese Eigenschaft nicht mehr ändern, nachdem die cloudPcProvisioningPolicy erstellt wurde. |
| scopeIds | String collection | Die Liste der Bereichstag-IDs für diese Ressource. Schreibgeschützt. |
| snapshotResetMode | cloudPcSnapshotResetMode | Gibt an, ob das Zurücksetzen der Momentaufnahme für diese Bereitstellungsrichtlinie verfügbar ist. Mögliche Werte sind: notApplicable, enabled, disabled, unknownFutureValue. Der Standardwert ist notApplicable. |
| userExperienceType | cloudPcUserExperienceType | Gibt den Typ des Cloudobjekts an, auf das der Endbenutzer zugreifen kann. Die möglichen Werte sind: cloudPc, cloudApp, unknownFutureValue.
cloudPc Gibt an, dass der Endbenutzer auf den gesamten Desktop zugreifen kann.
cloudApp Gibt an, dass der Endbenutzer nur auf Apps zugreifen kann, die unter dieser Bereitstellungsrichtlinie veröffentlicht wurden. Der Typ kann nicht mehr geändert werden, nachdem die Bereitstellungsrichtlinie erstellt wurde. Wenn bei der Erstellung nicht angegeben, ist cloudPcder Standardwert . Wenn cloudApp diese Option ausgewählt ist, muss der Bereitstellungstyp sein sharedByEntraGroup. Unterstützt $filter, $select, $orderBy. |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | Gibt bestimmte Einstellungen an, die die Persistenz von Benutzeranwendungseinstellungen zwischen Cloud PC-Sitzungen aktivieren. Der Standardwert ist null. Dieses Feature ist nur für Cloud PC-Bereitstellungsrichtlinien vom Typ sharedByEntraGroup. Unterstützt $select. |
| windowsSetting | cloudPcWindowsSettings | Gibt eine bestimmte Windows-Einstellung an, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden muss. Unterstützt $select. |
| domainJoinConfiguration (veraltet) | cloudPcDomainJoinConfiguration | Gibt an, wie Cloud-PCs der Microsoft Entra ID beitreten. Die domainJoinConfiguration-Eigenschaft ist veraltet und gibt ab dem 31. Mai 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die domainJoinConfigurations-Eigenschaft . |
| onPremisesConnectionId (veraltet) | Zeichenfolge | Die ID von cloudPcOnPremisesConnection. Um sicherzustellen, dass Cloud-PCs über Netzwerkkonnektivität verfügen und einer Domäne beitreten, wählen Sie eine Verbindung mit einem virtuellen Netzwerk aus, das vom Cloud-PC-Dienst überprüft wurde. Die onPremisesConnectionId-Eigenschaft ist veraltet und gibt ab dem 31. Mai 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die domainJoinConfigurations-Eigenschaft . |
| windowsSettings (veraltet) | cloudPcWindowsSettings | Bestimmte Windows-Einstellungen, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden müssen. Unterstützt $select. Die windowsSettings-Eigenschaft ist veraltet und gibt ab dem 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die windowsSetting-Eigenschaft . |
cloudPcProvisioningType-Werte
In der folgenden Tabelle sind die Elemente einer evolvierbaren Enumeration aufgeführt. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte in dieser entwicklungsfähigen Aufzählung abzurufen: sharedByUser, sharedByEntraGroup, reserve.
| Member | Beschreibung |
|---|---|
| dediziert | Gibt an, dass eine dedizierte Lizenz für die Bereitstellung von Cloud-PCs verwendet wird. Standardwert. |
| Shared (veraltet) | Gibt an, dass eine freigegebene Lizenz für die Bereitstellung von Cloud-PCs verwendet wird. Das shared Mitglied ist veraltet und wird ab dem 30. April 2027 nicht mehr zurückkehren. Verwenden Sie in Zukunft das sharedByUser Mitglied. |
| unknownFutureValue | Evolvable Enumeration Sentinel-Wert. Nicht verwenden. |
| sharedByUser | Gibt die Bereitstellungsrichtlinie an, wenn ein dedizierter Cloud-PC für jeden Benutzer in der Zuweisungsgruppe bereitgestellt wird. Die Benutzer sind immer mit demselben Cloud-PC verbunden. Die Verfügbarkeit von Cloud-PCs ist jedoch durch die Gesamtzahl der aktiven Sitzungen begrenzt. |
| sharedByEntraGroup | Gibt die Bereitstellungsrichtlinie für Cloud-PCs an, die von einer Microsoft Entra-Gruppe (Azure AD) freigegeben werden. Wenn ein gemeinsam genutzter Cloud-PC bereitgestellt wird, steht er jedem Benutzer in der Microsoft Entra ID-Zuweisungsgruppe zur Verfügung, mit dem eine Verbindung hergestellt werden kann. Die Benutzer können bei jeder Verbindung mit einem anderen Cloud-PC verbunden werden, und die Verfügbarkeit ist durch die Anzahl der bereitgestellten Cloud-PCs begrenzt. |
| Reservieren | Gibt an, dass die Richtlinie dedizierte, benutzergebundene, zeitgebundene Lizenzen verwenden soll, wenn Cloud-PCs bereitgestellt werden. Diese Cloud-PCs, die die Reserve-Richtlinie verwenden, können vom Benutzer mehrmals ausgecheckt und eingecheckt werden, und die zeitgebundene Lizenz wird erst verbraucht, nachdem der Cloud-PC ausgecheckt wurde. Derzeit kann jeder Benutzer 10 Stunden Nutzungszeit von jeder Reserve-Serviceplan-instance erhalten. |
cloudPcSnapshotResetMode-Werte
| Member | Beschreibung |
|---|---|
| notApplicable | Gibt an, dass das Zurücksetzen der Momentaufnahme nicht für die Bereitstellungsrichtlinie gilt. |
| aktiviert | Gibt an, dass das Zurücksetzen der Momentaufnahme für die Bereitstellungsrichtlinie aktiviert ist. |
| deaktiviert | Gibt an, dass das Zurücksetzen der Momentaufnahme für die Bereitstellungsrichtlinie deaktiviert ist. |
| unknownFutureValue | Evolvable Enumeration Sentinel-Wert. Nicht verwenden. |
cloudPcUserExperienceType-Werte
| Member | Beschreibung |
|---|---|
| cloudPc | Gibt an, dass Endbenutzer auf den gesamten Desktop zugreifen können. |
| cloudApp | Gibt an, dass Endbenutzer nur auf Cloud-Apps zugreifen können, die unter dieser Bereitstellungsrichtlinie veröffentlicht wurden. |
| unknownFutureValue | Evolvable Enumeration Sentinel-Wert. Nicht verwenden. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| assignments | cloudPcProvisioningPolicyAssignment-Sammlung | Eine definierte Auflistung von Bereitstellungsrichtlinienzuweisungen. Stellt die Gruppe der Microsoft 365-Gruppen und Sicherheitsgruppen in Microsoft Entra ID dar, denen eine Bereitstellungsrichtlinie zugewiesen ist. Wird nur auf $expand zurückgegeben. Ein Beispiel zum Abrufen der Zuweisungsbeziehung finden Sie unter Abrufen von cloudPcProvisioningPolicy. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
"alternateResourceUrl": "String",
"autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
"autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
"cloudPcGroupDisplayName": "String",
"cloudPcNamingTemplate": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"domainJoinConfiguration": {"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"},
"domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
"enableSingleSignOn": "Boolean",
"gracePeriodInHours": "Int32",
"id": "String (identifier)",
"imageDisplayName": "String",
"imageId": "String",
"imageType": "String",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"scopeIds": ["String"],
"snapshotResetMode": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}