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
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 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 | 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:
$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) | String | 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 |
|---|---|
| Gewidmet | 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 zeigt den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
"alternateResourceUrl": "String",
"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"
}
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für