Windows 365 (Vorschau)
Windows 365 ist ein cloudbasierter Dienst, der automatisch eine neue Windows-VM (Cloud-PC) für Ihre Endbenutzer erstellt. Jeder Cloud-PC wird einem einzelnen Benutzer als dediziertes Windows-Gerät zugewiesen. Windows 365 bietet die Vorteile von Produktivität, Sicherheit und Zusammenarbeit von Microsoft 365.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://powerautomate.microsoft.com/en-us/support/ |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://www.microsoft.com/en-us/windows-365 |
| Datenschutzrichtlinie | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorien | IT-Vorgänge; Produktivität |
Der Windows 365-Connector bietet Aktionen zum Verwalten von Windows 365 Cloud-PCs und Bereitstellungsrichtlinien in Ihrer Microsoft Intune-Umgebung. Mit diesem Connector können Sie Cloud PC-Lebenszyklusvorgänge, Bereitstellungsrichtlinienverwaltung und administrative Aufgaben über Power Automate-Flüsse automatisieren.
Dienst, Klasse und Regionen
| Dienstleistung | Klasse | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen |
| Logik-Apps | Premium | Alle Logik-Apps-Regionen |
| Power Apps | Premium | Alle Power Apps-Regionen |
| Power Automate | Premium | Alle Power Automate-Regionen |
Kontakt
| Kontakt | |
|---|---|
| Name | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
W365powerplatform@microsoft.com |
Voraussetzungen
Um diesen Connector zu verwenden, benötigen Sie Folgendes:
- Windows 365-Lizenzen für Ihre Organisation
- Microsoft Intune-Abonnement
- Ausreichende Berechtigungen in der rollenbasierten Zugriffssteuerung (RBAC) von Microsoft Intune zum Verwalten von Windows 365-Ressourcen
- Azure AD-Konto mit entsprechenden Berechtigungen
Erforderliche Berechtigungen
Benutzer müssen über eine der folgenden Intune-RBAC-Rollen verfügen:
- Globaler Administrator
- Intune-Dienstadministrator
- Windows365-Administrator (für Cloud-PC-spezifische Vorgänge)
- Benutzerdefinierte Rolle mit Windows 365-Berechtigungen (erfordert
Webhook.CreateundWebhook.Deletefür Triggervorgänge)
Wichtig: Für diesen Connector sind Windows 365-Lizenzen und entsprechende Microsoft Intune RBAC-Berechtigungen erforderlich. Alle Vorgänge verwenden die Microsoft Graph-API und unterliegen den Einschränkungen der Graph-API.
Bekannte Probleme und Einschränkungen
Der Windows 365-Connector befindet sich derzeit in der öffentlichen Vorschau.
Microsoft möchte, bevor wir einen Connector für die allgemeine Verfügbarkeit freigeben, sicherstellen, dass er stabil ist. Bis zu diesem Zeitpunkt befindet sich der Connector in der Vorschau. Vorschauen werden „wie besehen“, „mit allen Fehlern“ und „wie verfügbar“ zur Verfügung gestellt. Sie sind von den Vereinbarungen zum Servicelevel (SLAs) ausgenommen, werden aber auf Vorschaubasis zur Verfügung gestellt, damit Sie frühzeitig darauf zugreifen und Feedback geben können. Erfahren Sie mehr über Vorschaufeatures und deren Aktivierung. Vorschauen werden möglicherweise nicht vom Kundensupport abgedeckt. Sie können jederzeit ohne Vorankündigung eingestellt und möglicherweise nicht allgemein verfügbar gemacht werden.
Wir empfehlen Ihnen, die Vorschau-Konnektoren auszuprobieren und Feedback zu geben. Dies wird uns helfen, die Konnektoren zu stabilisieren und zu verbessern. Sie können die Produktforen zum Teilen von Problemen und Feedback verwenden. Der Microsoft-Support ist für die Vorschaufunktionen, einschließlich Connectors, möglicherweise nicht verfügbar, aber wir werden versuchen, Ihnen nach besten Kräften Support bereitzustellen. Weitere Informationen finden Sie in den Häufig gestellten Fragen zu Connectors in der Vorschau.
Allgemeine Grenzwerte
- Funktionen und Einschränkungen sind mit der zugrunde liegenden Graph-API konsistent.
- Wenn Sie etwas auf dem Graph-Betaendpunkt aufrufen müssen, verwenden Sie die HTTP-Anforderungsaktion.
Aktionen
Cloud-PCs auflisten
Vorgangs-ID: ListCloudPCs
Mit dieser Aktion können Sie Cloud-PCs auflisten.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| $select | Nein | Schnur | mit $select können Sie auswählen, welche Eigenschaften von Graph zurückgegeben werden. |
| $filter | Nein | Schnur | mit $filter können Sie nur eine Teilmenge einer Sammlung aus Graph abrufen. |
Rückgabe
| Name | Typ | Description |
|---|---|---|
| aadDeviceId | String | Die Microsoft Entra Geräte-ID für den Cloud-PC, die auch als Azure Active Directory-Geräte-ID (Azure AD) bezeichnet wird und aus 32 Zeichen im GUID-Format besteht. Wird auf einem virtuellen Computer generiert, der mit Microsoft Entra ID verknüpft ist. Schreibgeschützt |
| diskEncryptionState | String | Zeigt den Status der Datenträgerverschlüsselung an. |
| Anzeigename | String | Der Anzeigename für den Cloud-PC. Die maximale Länge beträgt 64 Zeichen. Schreibgeschützt |
| gracePeriodEndDateTime | DateTimeOffset | Das Datum und die Uhrzeit des Ablaufs der Toleranzperiode und die erneute Bereitstellung oder Aufhebung der Bereitstellung. Nur erforderlich, wenn der Status inGracePeriod ist. Der Zeitstempel wird im ISO 8601-Format und koordinierter Weltzeit (UTC) angezeigt. Mitternacht UTC am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. |
| id | String | Der eindeutige Bezeichner der kundenseitigen Cloud-PC-Entität, die aus 32 Zeichen in einem GUID-Format besteht. Schreibgeschützt |
| imageDisplayName | String | Der Name des Betriebssystemimages, das für den Cloud-PC verwendet wird. Die maximale Länge beträgt 50 Zeichen. Für diese Eigenschaft sind nur Buchstaben (A-Z, a-z), Zahlen (0-9) und Sonderzeichen (-,_,.) zulässig. Der Eigenschaftswert darf nicht mit einem Unterstrich beginnen oder enden. Schreibgeschützt |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung des Cloud-PCs. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. |
| managedDeviceId | String | Die Intune registrierte Geräte-ID für den Cloud-PC, die aus 32 Zeichen in einem GUID-Format besteht. Die managedDeviceId-Eigenschaft von Windows 365 Business Cloud-PCs ist immer NULL, da Windows 365 Business Cloud-PCs nicht automatisch von Windows 365 Intune registriert werden. Schreibgeschützt |
| managedDeviceName | String | Der Intune registrierten Gerätenamen für den Cloud-PC. Die managedDeviceName-Eigenschaft von Windows 365 Business Cloud-PCs ist immer null, da Windows 365 Business Cloud-PCs von Windows 365 nicht automatisch von Windows 365 registriert werden. Schreibgeschützt |
| onPremisesConnectionName | String | Die lokale Verbindung, die während der Bereitstellung von Cloud-PCs angewendet wurde. Schreibgeschützt |
| provisioningPolicyId | String | Die Bereitstellungsrichtlinien-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. Eine Richtlinie definiert den Typ des Cloud-PCs, den der Benutzer erstellen möchte. Schreibgeschützt |
| provisioningPolicyName | String | Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wurde. Die maximale Länge beträgt 120 Zeichen. Schreibgeschützt |
| provisioningType | String | Zeigt den Bereitstellungstyp an. |
| servicePlanId | String | Die Dienstplan-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. Weitere Informationen zu Serviceplänen finden Sie unter Produktnamen und Serviceplan-IDs für die Lizenzierung. Schreibgeschützt. |
| servicePlanName | String | Der Dienstplanname für die kundenorientierte Cloud-PC-Entität. Schreibgeschützt |
| servicePlanType | String | Zeigt den Plantyp an. |
| userPrincipalName | String | Der Benutzerprinzipalname (UPN) des Benutzers, der dem Cloud-PC zugewiesen ist. Die maximale Länge beträgt 113 Zeichen. Weitere Informationen zu Benutzernamenrichtlinien finden Sie unter Kennwortrichtlinien und Kontoeinschränkungen in der Microsoft Entra-ID. Schreibgeschützt. |
Abrufen von Bereitstellungsrichtlinien
Vorgangs-ID: GetProvisioningPoliciesV1
Mit dieser Aktion können Sie Informationen zu den Bereitstellungsrichtlinien zurückgeben.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| $select | Nein | String | mit $select können Sie auswählen, welche Eigenschaften von Graph zurückgegeben werden. |
| $filter | Nein | String | mit $filter können Sie nur eine Teilmenge einer Sammlung aus Graph abrufen. |
| $expand | Nein | String | mit $expand können Sie verwandte Ressourcen aus Graph zurückgeben. |
Rückgabe
Verwenden Sie $expand mit einem Wert von Zuordnungen, um die zurückgegebenen Werte unten anzuzeigen:
| Name | Typ | Description |
|---|---|---|
| cloudPCNamingTemplate | String | Die Vorlage, die verwendet wird, um Cloud-PCs zu benennen, die mit dieser Richtlinie bereitgestellt wurden. Die Vorlage kann benutzerdefinierte Text- und Ersetzungstoken enthalten, einschließlich %USERNAME:x% und %RAND:x%, die den Namen des Benutzers bzw. eine zufällig generierte Zahl darstellen. Beispielsweise bedeutet 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. |
| Beschreibung | String | Die Beschreibung der Bereitstellungsrichtlinie. |
| Anzeigename | String | Der Anzeigename für die Bereitstellungsrichtlinie. |
| domainJoinConfiguration | cloudPcDomainJoinConfiguration-Sammlung | Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs Microsoft Entra ID (Azure AD) beitreten. |
| enableSingleSignOn | Boolean | True, wenn auf den bereitgestellten Cloud-PC über einmaliges Anmelden zugegriffen werden kann. False gibt an, dass dieses Feature vom bereitgestellten Cloud-PC nicht unterstützt wird. Der Standardwert ist "false". Windows 365-Benutzer können einmaliges Anmelden verwenden, um sich bei Microsoft Entra-ID mit kennwortlosen Optionen (z. B. FIDO-Schlüsseln) zu authentifizieren, um auf ihren Cloud-PC zuzugreifen. |
| 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 |
| imageDisplayName | String | Der Anzeigename des Betriebssystemimages, das für die Bereitstellung verwendet wird. Beispiel: Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. |
| 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 jeden Parameter sind: publisher: Microsoftwindowsdesktop offer: 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 |
| Bildtyp | cloudPcProvisioningPolicyImageType | Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das für die Bereitstellung auf Cloud-PCs verwendet wird. Mögliche Werte sind: Katalog, benutzerdefiniert. Der Standardwert ist Katalog. |
Abrufen einer Bereitstellungsrichtlinie
Vorgangs-ID: GetAProvisioningPolicyV1
Mit dieser Aktion können Sie die Details einer bestimmten Bereitstellungsrichtlinie abrufen.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Bereitstellungsrichtlinien-ID | Yes | String | Die ID der Bereitstellungsrichtlinie. Muss enthalten sein. |
| $select | Nein | String | mit $select können Sie auswählen, welche Eigenschaften von Graph zurückgegeben werden. |
| $filter | Nein | String | mit $filter können Sie nur eine Teilmenge einer Sammlung aus Graph abrufen. |
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Erstellen einer Bereitstellungsrichtlinie
Vorgangs-ID: CreateAProvisioningPolicyV1
Mit dieser Aktion können Sie eine Bereitstellungsrichtlinie erstellen.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Name | Yes | String | Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wurde. Maximale Länge beträgt 120 Zeichen |
| Description | Yes | String | Die Beschreibung der Bereitstellungsrichtlinie. |
| Konfiguration des Domänenbeitritts | Yes | ||
| Bild-ID | Yes | String | Dies ist die Bild-ID, die Sie für die Bereitstellung von Cloud-PCs verwenden möchten. |
| Anzeigename des Bilds | Yes | String | Der Name des Betriebssystemimages, das für den Cloud-PC verwendet wird. Die maximale Länge beträgt 50 Zeichen. Für diese Eigenschaft sind nur Buchstaben (A-Z, a-z), Zahlen (0-9) und Sonderzeichen (-,_,.) zulässig. Der Eigenschaftswert darf nicht mit einem Unterstrich beginnen oder enden. |
| Imagetyp | Yes | String | Benutzerdefiniert oder Katalog. |
| Bereitstellungstyp | Yes | String | Freigegeben oder dediziert. |
| Windows-Einstellung/Gebietsschema | Yes | String | Geben Sie die Sprache/das Gebietsschema an, die Sie verwenden möchten. Windows 365 bietet über 30 solche Sprachen/Regionspaare. |
Sie können auch weitere Felder aus Graph unter erweiterten Parametern hinzufügen.
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Zuweisen einer Bereitstellungsrichtlinie zu einer Gruppe
Vorgangs-ID: AssignAProvisioningPolicyToAGroupV1
Mit dieser Aktion können Sie einer Bereitstellungsrichtlinie eine Gruppe zuweisen.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Bereitstellungsrichtlinien-ID | Yes | String | Dies ist die Bereitstellungsrichtlinien-ID, der Sie eine Gruppe zuweisen möchten. |
| Aufgaben – Zielgruppen-ID | Yes | String | Benutzergruppe aus entra ID. |
| Zuordnungen – Ziel-ServicePlan-ID | Nein | String | Der eindeutige Bezeichner für den Serviceplan, der angibt, welche Größe des Cloud-PCs für den Benutzer bereitgestellt werden soll. |
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Aktualisieren einer Bereitstellungsrichtlinie
Vorgangs-ID: UpdateAProvisioningPolicyV1
Mit dieser Aktion können Sie eine Bereitstellungsrichtlinie aktualisieren.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Bereitstellungsrichtlinien-ID | Yes | String | Dies ist die Bereitstellungsrichtlinien-ID der Bereitstellungsrichtlinie, die Sie aktualisieren möchten. |
| Description | Nein | String | Dies ist die Beschreibung der Bereitstellungsrichtlinien, auf die aktualisiert wird. |
Sie können auch weitere Felder aus Graph unter erweiterten Parametern hinzufügen.
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Abrufen einer Bereitstellungsrichtlinie
Vorgangs-ID: GetAProvisoningPolicyV1
Mit dieser Aktion können Sie die Details einer Bereitstellungsrichtlinie abrufen.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Bereitstellungsrichtlinien-ID | Yes | String | Die Bereitstellungsrichtlinien-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. Eine Richtlinie definiert den Typ des Cloud-PCs, den der Benutzer erstellen möchte. |
| $select | Nein | String | mit $select können Sie auswählen, welche Eigenschaften von Graph zurückgegeben werden. |
| $expand | Nein | String | mit $expand können Sie verwandte Ressourcen aus Graph zurückgeben. |
Sie können auch weitere Felder aus Graph unter erweiterten Parametern hinzufügen.
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Starten einer Remoteaktion
Vorgangs-ID: RemoteActions
Mit dieser Aktion können Sie eine Remoteaktion auf einem Cloud-PC starten.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Cloud-PC-ID | Yes | String | Auf diese Weise können Sie angeben, auf welche Cloud-PC-ID Sie mit einer Remoteaktion abzielen möchten. |
| Remoteaktion | Yes | String | Auf diese Weise können Sie auswählen, wann Remoteaktionen auf einem Cloud-PC ausgeführt werden sollen. |
| Remoteaktion – Momentaufnahme-ID | Nein | String | Wenn Sie sich für die Wiederherstellung eines Cloud-PCs entscheiden, müssen Sie auch eine Momentaufnahme-ID angeben. |
| Remoteaktion – Anzeigename | Nein | String | Wenn Sie einen Cloud-PC umbenennen möchten, müssen Sie auch einen Anzeigenamen angeben. |
Rückgabe
Wenn dies erfolgreich verläuft, wird der Antwortcode 204 "Kein Inhalt" zurückgegeben.
Senden einer Microsoft Graph-HTTP-Anforderung
Vorgangs-ID: HttpRequest
Mit dieser Aktion können Sie Graph direkt aufrufen und den Anruf anpassen.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| URI | Yes | String | Auf diese Weise können Sie angeben, welcher URI aufgerufen werden soll, z. B.: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents |
| Methode | Yes | String | Auf diese Weise können Sie die Aufrufmethode definieren. |
Sie können auch weitere Felder (Kopfzeilen, Textkörper usw.) unter "Erweiterte Parameter" hinzufügen.
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Auslöser
Alle Szenarien sind Teil eines Triggers, der im Triggertext selbst ausgewählt werden kann.
| Triggername | Beschreibung |
|---|---|
| Wenn eine Remoteaktion auf einem Cloud-PC ausgelöst wird | Ermöglicht es Ihnen, einen Fluss auszulösen, wenn eine Remoteaktion ausgelöst wird. |
| Wenn eine Remoteaktion auf einem Cloud-PC abgeschlossen ist | Ermöglicht es Ihnen, einen Fluss auszulösen, wenn eine Remoteaktion auf einem Cloud-PC abgeschlossen ist. |
| Wenn eine Bereitstellungsrichtlinie aktualisiert wird | Ermöglicht es Ihnen, einen Fluss auszulösen, wenn eine Bereitstellungsrichtlinie aktualisiert wird. |
| Beim Erstellen einer neuen Bereitstellungsrichtlinie | Ermöglicht es Ihnen, einen Fluss zu starten, wenn eine Bereitstellungsrichtlinie erstellt wird. |
| Beim Erstellen eines Cloud-PCs | Mit diesem Trigger können Sie einen Fluss starten, wenn ein Cloud-PC erstellt wird. |
Wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird
- Vorgangs-ID: Webhook
- Beschreibung: Dieser Trigger wird ausgelöst, wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird.
Parameter
| Name | Erforderlich | Typ | Description |
|---|---|---|---|
| Scenario | Yes | Dropdown | Sie können zwischen den unterstützten Szenarien wählen: |
| – Beim Erstellen eines Cloud-PCs | |||
| – Beim Erstellen einer neuen Bereitstellungsrichtlinie | |||
| – Wenn eine Bereitstellungsrichtlinie aktualisiert wird | |||
| – Wenn eine Remoteaktion auf einem Cloud-PC abgeschlossen ist | |||
| – Wenn eine Remoteaktion auf einem Cloud-PC ausgelöst wird |
Rückgabe
Die Ausgaben dieser Operation sind dynamisch.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen einer Bereitstellungsrichtlinie |
Ruft eine bestimmte Bereitstellungsrichtlinie ab. |
| Abrufen eines Cloud-PCs |
Ruft einen Cloud-PC ab |
| Abrufen von Bereitstellungsrichtlinien |
Ruft eine Liste der Bereitstellungsrichtlinien ab. |
| Aktualisieren einer Bereitstellungsrichtlinie |
Aktualisiert eine Bereitstellungsrichtlinie. |
| Cloud-PCs auflisten |
CloudPCs auflisten |
| Erstellen einer Bereitstellungsrichtlinie |
Erstellt eine Bereitstellungsrichtlinie. |
| Löschen einer Bereitstellungsrichtlinie |
Löscht eine Bereitstellungsrichtlinie. |
| Senden einer Microsoft Graph-HTTP-Anforderung (Vorschau) |
Erstellen einer Rest-API-Anforderung von Microsoft Graph |
| Starten einer Remoteaktion |
Starten Sie eine Remoteaktion auf einem Cloud-PC. |
| Zuweisen einer Bereitstellungsrichtlinie zu einer Gruppe |
Weisen Sie einer Gruppe eine Bereitstellungsrichtlinie zu. |
Abrufen einer Bereitstellungsrichtlinie
Ruft eine bestimmte Bereitstellungsrichtlinie ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Bereitstellungsrichtlinien-ID
|
id | True | string |
id |
|
Auswählen
|
$select | string |
Gibt Standardeigenschaften zurück, wenn nicht angegeben; Die erste Option gibt alle Eigenschaften zurück. |
|
|
Erweitern
|
$expand | string |
Erweitert verknüpfte Entitäten inline. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
assignments
|
assignments | array of object | |
|
items
|
assignments | object | |
|
Description
|
description | string |
Die Beschreibung der Bereitstellungsrichtlinie. |
|
Anzeigename
|
displayName | string |
Der Anzeigename der Bereitstellungsrichtlinie. |
|
Konfigurationen für den Domänenbeitritt
|
domainJoinConfigurations | array of object |
Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs Microsoft Entra ID beitreten. |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
type
|
domainJoinConfigurations.type | string |
type |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
Profil
|
microsoftManagedDesktop.profile | string |
Profil |
|
autopatchGroupId
|
autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeoutInMinutes
|
autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
onFailureDeviceAccessDenied
|
autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Einmaliges Anmelden aktivieren
|
enableSingleSignOn | boolean |
Gibt an, ob die Bereitstellungsrichtlinie SSO für Cloud-PCs aktiviert hat. |
|
Id
|
id | string |
id |
|
Anzeigename des Bilds
|
imageDisplayName | string |
Der Anzeigename für das Betriebssystemimage, das Sie bereitstellen. |
|
Bild-ID
|
imageId | string |
Die ID des Betriebssystemimages, das Sie auf Cloud-PCs bereitstellen möchten. |
|
Imagetyp
|
imageType | string |
Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das Sie auf Cloud-PCs bereitstellen möchten. |
|
Gebietsschema
|
windowsSetting.locale | string |
Gebietsschema |
|
Managedby
|
managedBy | string |
Managedby |
|
Bereitstellungstyp
|
provisioningType | string |
Gibt den Lizenztyp an, der beim Bereitstellen von Cloud-PCs mithilfe dieser Richtlinie verwendet wird. |
Abrufen eines Cloud-PCs
Ruft einen Cloud-PC ab
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Cloud-PC-ID
|
cloudPcId | True | string |
Der eindeutige Bezeichner des Cloud-PCs. |
|
Auswählen
|
$select | string |
Wählen Sie die zurückzugebenden Eigenschaften aus. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
id | string |
Der eindeutige Bezeichner der kundenseitigen Cloud-PC-Entität, die aus 32 Zeichen in einem GUID-Format besteht. |
|
Entra-Geräte-ID
|
aadDeviceId | string |
Die Microsoft Entra Geräte-ID für den Cloud-PC, die auch als Azure Active Directory-Geräte-ID (Azure AD) bezeichnet wird und aus 32 Zeichen im GUID-Format besteht. Wird auf einem virtuellen Computer generiert, der mit Microsoft Entra ID verknüpft ist. Schreibgeschützt |
|
Anzeigename
|
displayName | string |
Der Anzeigename für den Cloud-PC. Die maximale Länge beträgt 64 Zeichen. Schreibgeschützt |
|
Anzeigename des Bilds
|
imageDisplayName | string |
Der Name des Betriebssystemimages, das für den Cloud-PC verwendet wird. Die maximale Länge beträgt 50 Zeichen. |
|
Bereitstellungsrichtlinien-ID
|
provisioningPolicyId | string |
Die Bereitstellungsrichtlinien-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. Eine Richtlinie definiert den Typ des Cloud-PCs, den der Benutzer erstellen möchte. |
|
Name der Bereitstellungsrichtlinie
|
provisioningPolicyName | string |
Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wurde. |
|
Name der lokalen Verbindung
|
onPremisesConnectionName | string |
Die Azure-Netzwerkverbindung, die während der Bereitstellung von Cloud-PCs angewendet wurde. |
|
Serviceplan-ID
|
servicePlanId | string |
Die Dienstplan-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. |
|
Dienstplanname
|
servicePlanName | string |
Der Name des Serviceplans für die Vom Kunden acing Cloud PC-Entität. |
|
status
|
status | string |
status |
|
Benutzerprinzipalname
|
userPrincipalName | string |
Der Benutzerprinzipalname (UPN) des Benutzers, der dem Cloud-PC zugewiesen ist. |
|
Datum/Uhrzeit der letzten Änderung
|
lastModifiedDateTime | string |
Datum und Uhrzeit der letzten Änderung des Cloud-PCs. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. |
|
Verwaltete Geräte-ID
|
managedDeviceId | string |
Die Intune registrierte Geräte-ID für den Cloud-PC, die aus 32 Zeichen in einem GUID-Format besteht. |
|
Name des verwalteten Geräts
|
managedDeviceName | string |
Der Intune registrierten Gerätenamen für den Cloud-PC. |
|
Karenzzeit-Enddatum/-uhrzeit
|
gracePeriodEndDateTime | string |
Das Datum und die Uhrzeit des Ablaufs der Toleranzperiode und die erneute Bereitstellung oder Aufhebung der Bereitstellung. |
|
Datenträgerverschlüsselungsstatus
|
diskEncryptionState | string |
Datenträgerverschlüsselungsstatus |
|
Bereitstellungstyp
|
provisioningType | string |
Der Typ der Lizenzen, die bei der Bereitstellung von Cloud-PCs mit dieser Richtlinie verwendet werden sollen. |
|
Anzeigename für Zuweisen
|
allotmentDisplayName | string |
Anzeigename für Zuweisen |
|
Statusdetails
|
statusDetail | string |
Statusdetails |
|
Einmaliges Anmelden aktivieren
|
connectionSetting.enableSingleSignOn | boolean |
Einmaliges Anmelden aktivieren |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Abrufen von Bereitstellungsrichtlinien
Ruft eine Liste der Bereitstellungsrichtlinien ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Auswählen
|
$select | string |
Gibt Standardeigenschaften zurück, wenn nicht angegeben; Die erste Option gibt alle Eigenschaften zurück. |
|
|
Filter
|
$filter | string |
Filtert Elemente nach Eigenschaftswerten. |
|
|
Erweitern
|
$expand | string |
Erweitert verknüpfte Entitäten inline. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
assignments
|
value.assignments | array of object | |
|
items
|
value.assignments | object | |
|
Description
|
value.description | string |
Die Beschreibung der Bereitstellungsrichtlinie. |
|
Anzeigename
|
value.displayName | string |
Der Anzeigename der Bereitstellungsrichtlinie. |
|
Konfigurationen für den Domänenbeitritt
|
value.domainJoinConfigurations | array of object |
Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs Microsoft Entra ID beitreten. |
|
onPremisesConnectionId
|
value.domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
type
|
value.domainJoinConfigurations.type | string |
type |
|
managedType
|
value.microsoftManagedDesktop.managedType | string |
managedType |
|
Profil
|
value.microsoftManagedDesktop.profile | string |
Profil |
|
autopatchGroupId
|
value.autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
value.autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeoutInMinutes
|
value.autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
onFailureDeviceAccessDenied
|
value.autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Einmaliges Anmelden aktivieren
|
value.enableSingleSignOn | boolean |
Gibt an, ob die Bereitstellungsrichtlinie SSO für Cloud-PCs aktiviert hat. |
|
Id
|
value.id | string |
id |
|
Anzeigename des Bilds
|
value.imageDisplayName | string |
Der Anzeigename für das Betriebssystemimage, das Sie bereitstellen. |
|
Bild-ID
|
value.imageId | string |
Die ID des Betriebssystemimages, das Sie auf Cloud-PCs bereitstellen möchten. |
|
Imagetyp
|
value.imageType | string |
Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das Sie auf Cloud-PCs bereitstellen möchten. |
|
Gebietsschema
|
value.windowsSetting.locale | string |
Gebietsschema |
|
Managedby
|
value.managedBy | string |
Managedby |
|
Bereitstellungstyp
|
value.provisioningType | string |
Gibt den Lizenztyp an, der beim Bereitstellen von Cloud-PCs mithilfe dieser Richtlinie verwendet wird. |
Aktualisieren einer Bereitstellungsrichtlinie
Aktualisiert eine Bereitstellungsrichtlinie.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Bereitstellungsrichtlinien-ID
|
id | True | string |
id |
|
Gruppen-ID
|
autopatchGroupId | string |
autopatchGroupId |
|
|
Gerätevorbereitungsprofil-ID
|
devicePreparationProfileId | string |
devicePreparationProfileId |
|
|
Anwendungstimeout in Minuten
|
applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
|
Bei Ausfall des Gerätezugriffs verweigert
|
onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
|
Description
|
description | string |
Beschreibung |
|
|
Anzeigename
|
displayName | string |
Anzeigename |
|
|
Domänenbeitrittstyp
|
domainJoinType | string |
domainJoinType |
|
|
Lokale Verbindungs-ID
|
onPremisesConnectionId | string |
onPremisesConnectionId |
|
|
Regionsgruppe
|
regionGroup | string |
regionGroup |
|
|
Regionsname
|
regionName | string |
regionName |
|
|
Typ
|
type | string |
type |
|
|
Einmaliges Anmelden aktivieren
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
Anzeigename des Bilds
|
imageDisplayName | string |
imageDisplayName |
|
|
Bild-ID
|
imageId | string |
Imageid |
|
|
Imagetyp
|
imageType | string |
Bildtyp |
|
|
Verwalteter Typ
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
Profil |
|
|
Gebietsschema
|
locale | string |
Gebietsschema |
|
|
Weitere Felder
|
otherFields | object |
Weitere Felder |
Cloud-PCs auflisten
CloudPCs auflisten
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Auswählen
|
$select | string |
Wählen Sie die zurückzugebenden Eigenschaften aus. |
|
|
Filter
|
$filter | string |
Ex. provisioningPolicyName eq 'XXX' und userPrincipalName eq 'XXX' |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
id | string |
Der eindeutige Bezeichner der kundenseitigen Cloud-PC-Entität, die aus 32 Zeichen in einem GUID-Format besteht. |
|
Entra-Geräte-ID
|
aadDeviceId | string |
Die Microsoft Entra Geräte-ID für den Cloud-PC, die auch als Azure Active Directory-Geräte-ID (Azure AD) bezeichnet wird und aus 32 Zeichen im GUID-Format besteht. Wird auf einem virtuellen Computer generiert, der mit Microsoft Entra ID verknüpft ist. Schreibgeschützt |
|
Anzeigename
|
displayName | string |
Der Anzeigename für den Cloud-PC. Die maximale Länge beträgt 64 Zeichen. Schreibgeschützt |
|
Anzeigename des Bilds
|
imageDisplayName | string |
Der Name des Betriebssystemimages, das für den Cloud-PC verwendet wird. Die maximale Länge beträgt 50 Zeichen. |
|
Bereitstellungsrichtlinien-ID
|
provisioningPolicyId | string |
Die Bereitstellungsrichtlinien-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. Eine Richtlinie definiert den Typ des Cloud-PCs, den der Benutzer erstellen möchte. |
|
Name der Bereitstellungsrichtlinie
|
provisioningPolicyName | string |
Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wurde. |
|
Name der lokalen Verbindung
|
onPremisesConnectionName | string |
Die Azure-Netzwerkverbindung, die während der Bereitstellung von Cloud-PCs angewendet wurde. |
|
Serviceplan-ID
|
servicePlanId | string |
Die Dienstplan-ID für den Cloud-PC, die aus 32 Zeichen im GUID-Format besteht. |
|
Dienstplanname
|
servicePlanName | string |
Der Name des Serviceplans für die Vom Kunden acing Cloud PC-Entität. |
|
status
|
status | string |
status |
|
Benutzerprinzipalname
|
userPrincipalName | string |
Der Benutzerprinzipalname (UPN) des Benutzers, der dem Cloud-PC zugewiesen ist. |
|
Datum/Uhrzeit der letzten Änderung
|
lastModifiedDateTime | string |
Datum und Uhrzeit der letzten Änderung des Cloud-PCs. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. |
|
Verwaltete Geräte-ID
|
managedDeviceId | string |
Die Intune registrierte Geräte-ID für den Cloud-PC, die aus 32 Zeichen in einem GUID-Format besteht. |
|
Name des verwalteten Geräts
|
managedDeviceName | string |
Der Intune registrierten Gerätenamen für den Cloud-PC. |
|
Karenzzeit-Enddatum/-uhrzeit
|
gracePeriodEndDateTime | string |
Das Datum und die Uhrzeit des Ablaufs der Toleranzperiode und die erneute Bereitstellung oder Aufhebung der Bereitstellung. |
|
Datenträgerverschlüsselungsstatus
|
diskEncryptionState | string |
Datenträgerverschlüsselungsstatus |
|
Bereitstellungstyp
|
provisioningType | string |
Der Typ der Lizenzen, die bei der Bereitstellung von Cloud-PCs mit dieser Richtlinie verwendet werden sollen. |
|
Anzeigename für Zuweisen
|
allotmentDisplayName | string |
Anzeigename für Zuweisen |
|
Statusdetails
|
statusDetail | string |
Statusdetails |
|
Einmaliges Anmelden aktivieren
|
connectionSetting.enableSingleSignOn | boolean |
Gibt an, ob die Bereitstellungsrichtlinie SSO für Cloud-PCs aktiviert hat. |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Erstellen einer Bereitstellungsrichtlinie
Erstellt eine Bereitstellungsrichtlinie.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
displayName | True | string |
Anzeigename |
|
Description
|
description | True | string |
Beschreibung |
|
domainJoinType
|
domainJoinType | string | ||
|
type
|
type | string | ||
|
regionName
|
regionName | string | ||
|
onPremisesConnectionId
|
onPremisesConnectionId | string | ||
|
regionGroup
|
regionGroup | string | ||
|
Weitere Felder
|
otherFields | object |
Weitere Felder |
|
|
Einmaliges Anmelden aktivieren
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
Bild-ID
|
imageId | True | string |
Imageid |
|
Anzeigename des Bilds
|
imageDisplayName | True | string |
imageDisplayName |
|
Imagetyp
|
imageType | True | string |
Bildtyp |
|
Bereitstellungstyp
|
provisioningType | True | string |
provisioningType |
|
Gebietsschema
|
locale | True | string |
Gebietsschema |
|
Verwalteter Typ
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
Profil |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string |
id |
|
Anzeigename
|
displayName | string |
Der Anzeigename der Bereitstellungsrichtlinie. |
|
Description
|
description | string |
Die Beschreibung der Bereitstellungsrichtlinie. |
|
Bild-ID
|
imageId | string |
Die ID des Betriebssystemimages, das Sie auf Cloud-PCs bereitstellen möchten. |
|
Anzeigename des Bilds
|
imageDisplayName | string |
Der Anzeigename für das Betriebssystemimage, das Sie bereitstellen. |
|
Imagetyp
|
imageType | string |
Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das Sie auf Cloud-PCs bereitstellen möchten. |
|
Einmaliges Anmelden aktivieren
|
enableSingleSignOn | boolean |
Gibt an, ob die Bereitstellungsrichtlinie SSO für Cloud-PCs aktiviert hat. |
|
Benennungsvorlage für Cloud-PC
|
cloudPcNamingTemplate | string |
Die Vorlage, die verwendet wird, um Cloud-PCs zu benennen, die mit dieser Richtlinie bereitgestellt wurden. |
|
Bereitstellungstyp
|
provisioningType | string |
Gibt den Lizenztyp an, der beim Bereitstellen von Cloud-PCs mithilfe dieser Richtlinie verwendet wird. |
|
Managedby
|
managedBy | string |
Managedby |
|
scopeIds
|
scopeIds | array of |
scopeIds |
|
AutoPatch-Einstellungen
|
autopatch | string |
Gibt die Windows Autopatch-Einstellungen für Cloud-PCs an, die diese Bereitstellungsrichtlinie verwenden. |
|
autopilotConfiguration
|
autopilotConfiguration | string |
autopilotConfiguration |
|
domainJoinConfigurations
|
domainJoinConfigurations | array of object |
domainJoinConfigurations |
|
domainJoinType
|
domainJoinConfigurations.domainJoinType | string |
domainJoinType |
|
type
|
domainJoinConfigurations.type | string |
type |
|
regionName
|
domainJoinConfigurations.regionName | string |
regionName |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
regionGroup
|
domainJoinConfigurations.regionGroup | string |
regionGroup |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
type
|
microsoftManagedDesktop.type | string |
type |
|
Profil
|
microsoftManagedDesktop.profile | string |
Profil |
|
Gebietsschema
|
windowsSetting.locale | string |
Gebietsschema |
|
language
|
windowsSettings.language | string |
language |
Löschen einer Bereitstellungsrichtlinie
Löscht eine Bereitstellungsrichtlinie.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Bereitstellungsrichtlinien-ID
|
id | True | string |
id |
Senden einer Microsoft Graph-HTTP-Anforderung (Vorschau)
Erstellen einer Rest-API-Anforderung von Microsoft Graph
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
Der vollständige oder relative URI. Beispiel: |
|
Methode
|
Method | True | string |
Die HTTP-Methode (Standard ist GET) |
|
Body
|
Body | binary |
Der Anforderungstextinhalt |
|
|
Inhaltstyp
|
ContentType | string |
Der Inhaltstypheader für den Textkörper (Standard ist "application/json") |
|
|
CustomHeader1
|
CustomHeader1 | string |
Benutzerdefinierte Kopfzeile 1. Im Format angeben: Headername: Headerwert |
|
|
CustomHeader2
|
CustomHeader2 | string |
Benutzerdefinierte Kopfzeile 2. Im Format angeben: Headername: Headerwert |
|
|
CustomHeader3
|
CustomHeader3 | string |
Benutzerdefinierte Kopfzeile 3. Im Format angeben: Headername: Headerwert |
|
|
CustomHeader4
|
CustomHeader4 | string |
Benutzerdefinierte Kopfzeile 4. Im Format angeben: Headername: Headerwert |
|
|
CustomHeader5
|
CustomHeader5 | string |
Benutzerdefinierte Kopfzeile 5. Im Format angeben: Headername: Headerwert |
Gibt zurück
- response
- ObjectWithoutType
Starten einer Remoteaktion
Starten Sie eine Remoteaktion auf einem Cloud-PC.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Cloud-PC-ID
|
cloudPcId | True | string |
Der eindeutige Bezeichner des Cloud-PCs. |
|
Remoteaktion
|
remoteAction | True | string |
Die Remoteaktion, die auf dem Cloud-PC ausgeführt werden soll. |
|
Cloud PC-Momentaufnahme-ID
|
cloudPcSnapshotId | string |
Erforderlich für die Wiederherstellung |
|
|
Anzeigename
|
displayName | string |
Erforderlich für die Umbenennung |
Zuweisen einer Bereitstellungsrichtlinie zu einer Gruppe
Weisen Sie einer Gruppe eine Bereitstellungsrichtlinie zu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Bereitstellungsrichtlinien-ID
|
id | True | string |
id |
|
Bereitstellungsrichtlinien-ID
|
id | string |
Dies ist die Bereitstellungsrichtlinien-ID, der Sie eine Gruppe zuweisen möchten. |
|
|
Gruppen-ID
|
groupId | True | string |
groupId |
|
servicePlanId
|
servicePlanId | string |
Zieldienstplan-ID |
Trigger
| Wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird |
Wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird |
Wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird
Wenn eine Bereitstellungsrichtlinie oder ein Cloud-PC aktualisiert wird
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Szenario
|
scenario | True | string |
Szenario |