Freigeben über


cloudPcProvisioningPolicy-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Cloud-PC-Bereitstellungsrichtlinie dar.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List cloudPcProvisioningPolicy-Sammlung Auflisten der Eigenschaften und Beziehungen der cloudPcProvisioningPolicy-Objekte .
Create cloudPcProvisioningPolicy Create ein neues cloudPcProvisioningPolicy-Objekt.
Get cloudPcProvisioningPolicy Liest die Eigenschaften und Beziehungen eines cloudPcProvisioningPolicy-Objekts .
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.

Eigenschaften

Eigenschaft Typ Beschreibung
alternateResourceUrl Zeichenfolge Die URL der alternativen Ressource, die mit dieser Bereitstellungsrichtlinie verknüpft ist. Schreibgeschützt.
cloudPcGroupDisplayName Zeichenfolge Der Anzeigename der Cloud-PC-Gruppe, in der sich die Cloud-PCs befinden. Schreibgeschützt.
cloudPcNamingTemplate Zeichenfolge 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 Zeichenfolge 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 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 Zeichenfolge 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 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.
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"}
}