cloudPcProvisioningPolicy-Ressourcentyp

Artikel
09/28/2024

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 `starterManaged`festgelegt 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-m365`und `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 `true`ist 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"
  }
}

Freigeben über