Partager via

Créer cloudPcOnPremisesConnection

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Créez un objet cloudPcOnPremisesConnection pour provisionner des PC cloud.

Importante

La connexion réseau locale a été renommée connexion réseau Azure. Les objets cloudPcOnPremisesConnection sont ici équivalents à la connexion réseau Azure pour le produit PC cloud.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) CloudPC.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

Requête HTTP

POST /deviceManagement/virtualEndpoint/onPremisesConnections

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet cloudPcOnPremisesConnection .

Le tableau suivant répertorie les propriétés requises lorsque vous créez l’objet cloudPcOnPremisesConnection .

Propriété Type Description
displayName Chaîne Nom complet de la connexion réseau Azure.
connectionType cloudPcOnPremisesConnectionType Spécifie la méthode par laquelle un PC cloud approvisionné est joint à Microsoft Entra. L’option azureADJoin indique l’absence d’un Active Directory local (AD) dans le locataire actuel, ce qui entraîne la jointure de l’appareil PC cloud uniquement à Microsoft Entra. L’option hybridAzureADJoin indique la présence d’un ad local dans le locataire actuel et que le PC cloud joint à la fois l’AD local et Microsoft Entra. L’option sélectionnée détermine également les types d’utilisateurs qui peuvent être affectés et qui peuvent se connecter à un PC cloud. L’option azureADJoin permet aux utilisateurs cloud uniquement et hybrides d’être affectés et de se connecter, alors qu’elle hybridAzureADJoin est limitée aux utilisateurs hybrides uniquement. La valeur par défaut est hybridAzureADJoin. Les valeurs possibles sont hybridAzureADJoin, azureADJoin, unknownFutureValue.
subscriptionId Chaîne ID de l’abonnement Azure cible associé à votre locataire.
adDomainName Chaîne Nom de domaine complet (FQDN) du domaine Active Directory que vous souhaitez joindre.
adDomainPassword Chaîne Mot de passe associé à adDomainUsername.
adDomainUsername Chaîne Nom d’utilisateur d’un compte Active Directory (compte d’utilisateur ou de service) qui dispose des autorisations nécessaires pour créer des objets ordinateur dans Active Directory. Format requis : admin@contoso.com.
displayName Chaîne Nom complet de la connexion réseau Azure.
resourceGroupId Chaîne ID du groupe de ressources cible. Format requis : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName} ».
subnetId Chaîne ID du sous-réseau cible. Format requis : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName} ».
type (déconseillé) cloudPcOnPremisesConnectionType Spécifie la façon dont le PC cloud approvisionné se joint à Microsoft Entra ID. La valeur par défaut est hybridAzureADJoin. Les valeurs possibles sont hybridAzureADJoin, azureADJoin et unknownFutureValue. La propriété type est déconseillée et a cessé de retourner des données le 31 janvier 2024. Avancez vers l’avant, utilisez la propriété connectionType .
subscriptionId Chaîne ID de l’abonnement Azure cible associé à votre locataire.
virtualNetworkId Chaîne ID du réseau virtuel cible. Format requis : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName} ».
type cloudPcOnPremisesConnectionType Spécifie la façon dont le PC cloud approvisionné se joint à Microsoft Entra ID. La valeur par défaut est hybridAzureADJoin. Les valeurs possibles sont azureADJoin, hybridAzureADJoin et unknownFutureValue.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet cloudPcOnPremisesConnection dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

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"
}

Réponse

L’exemple suivant illustre la réponse.

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"
}