cloudPcProvisioningPolicy-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Cloud-PC-Bereitstellungsrichtlinie dar.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
Auflisten von provisioningPolicies	cloudPcProvisioningPolicy-Sammlung	Auflisten der Eigenschaften und Beziehungen der cloudPcProvisioningPolicy-Objekte .
Erstellen von cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Erstellen Sie ein neues cloudPcProvisioningPolicy-Objekt .
Abrufen von cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Liest die Eigenschaften und Beziehungen eines cloudPcProvisioningPolicy-Objekts .
Aktualisieren von cloudPcProvisioningPolicy	cloudPcProvisioningPolicy	Aktualisieren sie die Eigenschaften eines cloudPcProvisioningPolicy-Objekts .
Löschen von cloudPcProvisioningPolicy	Keine	Löschen sie ein cloudPcProvisioningPolicy-Objekt .
Assign	Keine	Weisen Sie Benutzergruppen eine cloudPcProvisioningPolicy zu.

Eigenschaften

Eigenschaft	Typ	Beschreibung
alternateResourceUrl	String	Die URL der alternativen Ressource, die mit dieser Bereitstellungsrichtlinie verknüpft ist. Schreibgeschützt.
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	String	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 auf den bereitgestellten Cloud-PC per einmaligem Anmelden zugegriffen werden 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. Unterstützt $filter, $select und $orderBy. Schreibgeschützt. Geerbt von entity.
imageDisplayName	String	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	String	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.
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 Lizenztyp an, der beim Bereitstellen von Cloud-PCs mithilfe dieser Richtlinie verwendet 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. Mögliche Werte sind: dedicated, shared und unknownFutureValue.
windowsSetting	cloudPcWindowsSetting	Gibt eine bestimmte Windows-Einstellung an, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden soll. Unterstützt $select.

cloudPcProvisioningPolicyImageType-Werte

Member	Beschreibung
Benutzerdefinierte	Gibt an, dass die Bereitstellungsrichtlinie für das Cloud-PC-Betriebssystemimage auf Benutzerdefiniertes Image festgelegt ist. Benutzerdefinierte Images müssen von den IT-Administratoren erstellt, konfiguriert und hochgeladen werden.
Galerie	Gibt an, dass die Bereitstellungsrichtlinie für das Cloud-PC-Betriebssystemimage auf Katalogimage festgelegt ist. Katalogimages sind optimierte Windows-Images, die von Microsoft bereitgestellt werden.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

cloudPcProvisioningType-Werte

Member	Beschreibung
Gewidmet	Gibt an, dass eine dedizierte Lizenz für die Bereitstellung von Cloud-PCs verwendet wird. Standardwert.
freigegeben	Gibt an, dass eine freigegebene Lizenz für die Bereitstellung von Cloud-PCs verwendet wird.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

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 zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "description": "String",
  "displayName": "String",
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "localAdminEnabled": "Boolean",
  "microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
  "provisioningType": "String",
  "windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"}
}