Erstellen von cloudPcOnPremisesConnection

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.

Erstellen Sie ein neues cloudPcOnPremisesConnection-Objekt für die Bereitstellung von Cloud-PCs.

Wichtig

Die lokale Netzwerkverbindung wurde in Azure-Netzwerkverbindung umbenannt. cloudPcOnPremisesConnection-Objekte entsprechen hier der Azure-Netzwerkverbindung für das Cloud-PC-Produkt.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) CloudPC.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /deviceManagement/virtualEndpoint/onPremisesConnections

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des cloudPcOnPremisesConnection-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen des cloudPcOnPremisesConnection-Objekts erforderlich sind.

Eigenschaft Typ Beschreibung
displayName String Der Anzeigename für die Azure-Netzwerkverbindung.
connectionType cloudPcOnPremisesConnectionType Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verknüpft wird. Die azureADJoin Option gibt an, dass im aktuellen Mandanten kein lokales Active Directory (AD) vorhanden ist, was dazu führt, dass das Cloud-PC-Gerät nur mit Microsoft Entra verknüpft wird. Die hybridAzureADJoin Option gibt an, dass ein lokales AD im aktuellen Mandanten vorhanden ist und dass der Cloud-PC sowohl mit dem lokalen AD als auch Microsoft Entra verknüpft wird. Die ausgewählte Option bestimmt auch die Benutzertypen, die zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Mit azureADJoin der Option können sowohl reine Cloudbenutzer als auch Hybridbenutzer zugewiesen und angemeldet werden, während hybridAzureADJoin sie nur auf Hybridbenutzer beschränkt ist. Der Standardwert ist hybridAzureADJoin. Die möglichen Werte sind: hybridAzureADJoin, azureADJoin, unknownFutureValue.
subscriptionId String Die ID des Azure-Zielabonnements, das Ihrem Mandanten zugeordnet ist.
adDomainName String Der vollqualifizierte Domänenname (FQDN) der Active Directory-Domäne, der Sie beitreten möchten.
adDomainPassword String Das Kennwort, das adDomainUsername zugeordnet ist.
adDomainUsername String Der Benutzername eines Active Directory-Kontos (Benutzer- oder Dienstkonto), das über Berechtigungen zum Erstellen von Computerobjekten in Active Directory verfügt. Erforderliches Format: admin@contoso.com.
displayName String Der Anzeigename für die Azure-Netzwerkverbindung.
resourceGroupId String Die ID der Zielressourcengruppe. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}".
subnetId String Die ID des Zielsubnetzes. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}".
type (veraltet) cloudPcOnPremisesConnectionType Gibt an, wie der bereitgestellte Cloud-PC mit Microsoft Entra ID verknüpft wird. Der Standardwert ist hybridAzureADJoin. Mögliche Werte sind: hybridAzureADJoin, azureADJoin und unknownFutureValue. Die type-Eigenschaft ist veraltet und gibt am 31. Januar 2024 keine Daten mehr zurück. Gehen Sie vorwärts, verwenden Sie die connectionType-Eigenschaft .
subscriptionId String Die ID des Azure-Zielabonnements, das Ihrem Mandanten zugeordnet ist.
virtualNetworkId String Die ID des virtuellen Zielnetzwerks. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}".
type cloudPcOnPremisesConnectionType Gibt an, wie der bereitgestellte Cloud-PC mit Microsoft Entra ID verknüpft wird. Der Standardwert ist hybridAzureADJoin. Mögliche Werte sind: azureADJoin, hybridAzureADJoin und unknownFutureValue.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein cloudPcOnPremisesConnection-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremisesConnections
Content-Type: application/json

{
  "displayName": "test-canary-02",
  "connectionType": "hybridAzureADJoin",
  "type": "hybridAzureADJoin",
  "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
  "adDomainName": "contoso001.com",
  "adDomainUsername": "dcadmin",
  "organizationalUnit": "OU=Domain Controllers, DC=contoso001, DC=com",
  "resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG",
  "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG/providers/Microsoft.Network/virtualNetworks/canary01-MyVNET",
  "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG/providers/Microsoft.Network/virtualNetworks/canary01-MyVNET/subnets/canary01-Subnet"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "id": "ac2ad805-167e-49ee-9bef-196c4ce7ffff",
  "managedBy": "windows365",
  "displayName": "test-canary-02",
  "connectionType": "hybridAzureADJoin",
  "type": "hybridAzureADJoin",
  "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
  "subscriptionName": "CPC customer 001 test subscription",
  "adDomainName": "contoso001.com",
  "adDomainUsername": "dcadmin",
  "organizationalUnit": "OU=Domain Controllers, DC=contoso001, DC=com",
  "resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG",
  "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG/providers/Microsoft.Network/virtualNetworks/canary01-MyVNET",
  "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ad47/resourceGroups/CustomerRG/providers/Microsoft.Network/virtualNetworks/canary01-MyVNET/subnets/canary01-Subnet",
  "healthCheckStatus": "pending"
}