Freigeben über


cloudPcProvisioningPolicy-Ressourcentyp

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 Auflisten der Eigenschaften und Beziehungen der cloudPcProvisioningPolicy-Objekte .
Get cloudPcProvisioningPolicy Liest die Eigenschaften und Beziehungen eines cloudPcProvisioningPolicy-Objekts .
Create cloudPcProvisioningPolicy Erstellen Sie ein neues cloudPcProvisioningPolicy-Objekt .
Update cloudPcProvisioningPolicy Aktualisieren sie die Eigenschaften eines cloudPcProvisioningPolicy-Objekts .
Delete 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. Derzeit können Sie nur die Region ändern.
Konfiguration anwenden Keine Aktualisieren Sie die Konfiguration der Bereitstellungsrichtlinie für eine Gruppe von Cloud-PC-Geräten anhand ihrer IDs.

Eigenschaften

Eigenschaft Typ Beschreibung
alternateResourceUrl Zeichenfolge Die URL der alternativen Ressource, die mit dieser Bereitstellungsrichtlinie verknüpft ist. Schreibgeschützt.
Autopatch cloudPcProvisioningPolicyAutopatch Die spezifischen Einstellungen für windows Autopatch, die es seinen Kunden ermöglichen, es auf Cloud-PC zu erleben. Die Einstellungen werden wirksam, wenn sich der Mandant bei Windows Autopatch registriert und die managedType-Eigenschaft der microsoftManagedDesktop-Eigenschaft auf starterManagedfestgelegt ist. Unterstützt $select.
autopilotConfiguration cloudPcAutopilotConfiguration Die spezifischen Einstellungen für Windows Autopilot, die es Windows 365 Kunden ermöglichen, es auf Cloud-PCs zu erleben. Unterstützt $select.
cloudPcGroupDisplayName String Der Anzeigename der Cloud-PC-Gruppe, in der sich die Cloud-PCs befinden. Schreibgeschützt.
cloudPcNamingTemplate String Die Vorlage, die verwendet wird, um Cloud-PCs zu benennen, die mit dieser Richtlinie bereitgestellt wurden. Die Vorlage kann benutzerdefinierte Text- und Ersatztoken enthalten, einschließlich %USERNAME:x% und %RAND:x%, die den Namen des Benutzers bzw. 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 Texts darf 15 Zeichen nicht überschreiten. Unterstützt $filter, $select und $orderby.
description String Die Beschreibung der Bereitstellungsrichtlinie. Unterstützt $filter, $select und $orderBy.
displayName Zeichenfolge Der Anzeigename für die Bereitstellungsrichtlinie.
domainJoinConfigurations cloudPcDomainJoinConfiguration-Sammlung Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs Microsoft Entra ID (Azure AD) beitreten. Unterstützt $select.
enableSingleSignOn Boolesch True , wenn einmaliges Anmelden 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 sich mithilfe des einmaligen Anmeldens bei Microsoft Entra ID mit kennwortlosen Optionen (z. B. FIDO-Schlüsseln) 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 String Der eindeutige Bezeichner, der der Bereitstellungsrichtlinie zugeordnet ist. Diese ID wird während der Erstellung einer neuen Bereitstellungsrichtlinie automatisch aufgefüllt. Schreibgeschützt. Unterstützt $filter, $select und $orderBy.
imageDisplayName Zeichenfolge Der Anzeigename des Betriebssystemimages, 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 für die Bereitstellung neuer Cloud-PCs verwendet wird. Das Format für ein Katalogtypimage lautet: {publisherName_offerName_skuName}. Unterstützte Werte für die einzelnen Parameter sind:
  • Verlag: Microsoftwindowsdesktop
  • Angebot: windows-ent-cpc
  • sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, , 19h2-ent-cpc-m365und 19h2-ent-cpc-os
Unterstützt $filter, $select und $orderBy.
imageType cloudPcProvisioningPolicyImageType Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das für die Bereitstellung auf Cloud-PCs verwendet wird. Mögliche Werte sind: gallery und custom. Der Standardwert ist gallery. Unterstützt $filter, $select und $orderBy.
localAdminEnabled Boolesch Bei trueist der lokale Administrator für Cloud-PCs aktiviert. false Gibt an, dass der lokale Administrator nicht für Cloud-PCs 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: windows365, devBox, unknownFutureValue, rpaBox Der Standardwert ist windows365. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um den folgenden Wert in dieser verteilbaren Enumeration abzurufen: rpaBox. Unterstützt $filter, $select und $orderBy.
microsoftManagedDesktop microsoftManagedDesktop Die spezifischen Einstellungen für microsoftManagedDesktop , mit denen Microsoft Managed Desktop-Kunden geräteseitig verwaltete Funktionen für Cloud-PCs erhalten können. Damit microsoftManagedDesktop mehr Wert bietet, muss ein Administrator bestimmte Einstellungen angeben. Unterstützt $filter, $select und $orderBy.
provisioningType cloudPcProvisioningType Gibt den Typ 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 Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: sharedByUser, sharedByEntraGroup. Der shared Member ist veraltet und wird am 30. April 2027 nicht mehr zurückgegeben. Verwenden Sie in Zukunft den sharedByUser Member. Beispielsweise kann ein dedicated Serviceplan nur einem Benutzer zugewiesen werden und nur einen Cloud-PC bereitstellen. Die shared Pläne und sharedByUser erfordern, dass Kunden einen Plan für gemeinsame Dienste 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 Erwerb eines Gemeinsamen Dienstplans. Jede freigegebene Lizenz unter diesem Plan kann einen Cloud-PC aktivieren, der gemäß den Zuweisungen dieser Richtlinie für die Gruppe freigegeben wird. Standardmäßig ist dedicated der Lizenztyp, wenn der provisioningType beim Erstellen der cloudPcProvisioningPolicy nicht angegeben wird. Sie können diese Eigenschaft nicht mehr ändern, nachdem die cloudPcProvisioningPolicy erstellt wurde.
windowsSetting cloudPcWindowsSettings Gibt eine bestimmte Windows-Einstellung an, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden soll. Unterstützt $select.
domainJoinConfiguration (veraltet) cloudPcDomainJoinConfiguration Gibt an, wie Cloud-PCs Microsoft Entra ID. Die DomainJoinConfiguration-Eigenschaft ist veraltet und gibt am 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 in die Domäne eingebunden werden, 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 am 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 sollen. Unterstützt $select. Die windowsSettings-Eigenschaft ist veraltet und gibt am 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 drehbaren Enumeration aufgeführt. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: sharedByUser, sharedByEntraGroup.

Member Beschreibung
dediziert Gibt an, dass eine dedizierte Lizenz für die Bereitstellung von Cloud-PCs verwendet wird. Standardwert.
freigegeben (veraltet) Gibt an, dass eine freigegebene Lizenz für die Bereitstellung von Cloud-PCs verwendet wird. Der shared Member ist veraltet und wird am 30. April 2027 nicht mehr zurückgegeben. Verwenden Sie in Zukunft das sharedByUser -Element.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
sharedByUser Gibt die Bereitstellungsrichtlinie an, wenn für jeden Benutzer in der Zuweisungsgruppe ein dedizierter Cloud-PC bereitgestellt wird. Benutzer sind immer mit demselben Cloud-PC verbunden. Die Verfügbarkeit von Cloud-PCs ist jedoch durch die Gesamtzahl der aktiven Sitzungen beschränkt.
sharedByEntraGroup Gibt die Bereitstellungsrichtlinie an, die Cloud-PCs zugeordnet ist, die von einer Microsoft Entra -Gruppe (Azure AD) gemeinsam genutzt werden. Wenn ein freigegebener Cloud-PC bereitgestellt wird, ist er für jeden Benutzer in der Microsoft Entra ID Zuweisungsgruppe verfügbar, mit dem eine Verbindung hergestellt werden kann. Benutzer können bei jeder Verbindung mit einem anderen Cloud-PC verbunden sein, und die Verfügbarkeit ist durch die Anzahl der bereitgestellten Cloud-PCs beschränkt.

Beziehungen

Beziehung Typ Beschreibung
assignments cloudPcProvisioningPolicyAssignment-Sammlung Eine definierte Sammlung von Bereitstellungsrichtlinienzuweisungen. Stellt den Satz von 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 Zuordnungsbeziehung 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",
  "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",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {
    "@odata.type": "microsoft.graph.microsoftManagedDesktop"
  },
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "windowsSetting": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSetting"
  },
  "windowsSettings": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSettings"
  }
}