type de ressource cloudPcOnPremisesConnection

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 .

Représente un ensemble défini d’informations sur les ressources Azure qui peuvent être utilisées pour établir la connectivité réseau Azure pour les 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 Cloud PC.

Méthodes

Méthode Type de retour Description
List collection cloudPcOnPremisesConnection Répertorier les propriétés et les relations des objets cloudPcOnPremisesConnection .
Obtenir cloudPcOnPremisesConnection Lisez les propriétés et les relations de l’objet cloudPcOnPremisesConnection .
Create cloudPcOnPremisesConnection Créez un objet cloudPcOnPremisesConnection .
Mettre à jour cloudPcOnPremisesConnection Mettez à jour les propriétés d’un objet cloudPcOnPremisesConnection .
Supprimer Aucun Supprimez un objet cloudPcOnPremisesConnection . Vous ne pouvez pas supprimer une connexion en cours d’utilisation.
Exécuter les vérifications de l’intégrité Aucun Exécutez des vérifications d’intégrité sur cloudPcOnPremisesConnection.
Mettre à jour le mot de passe de domaine Active Directory Aucun Mettez à jour le mot de passe de domaine Active Directory pour une connexion cloudPcOnPremisesConnection réussie.

Propriétés

Propriété Type Description
adDomainName String Le nom de domaine complet (FQDN) du domaine Active Directory que vous souhaitez joindre. Facultatif.
adDomainPassword String Mot de passe associé à adDomainUsername.
adDomainUsername String Nom d’utilisateur d’un compte Active Directory (compte d’utilisateur ou de service) autorisé à créer des objets ordinateur dans Active Directory. Format obligatoire : admin@contoso.com. Facultatif.
alternateResourceUrl String URL d’interface de la ressource du service partenaire liée à cette connexion réseau Azure. Besoin $select de récupération.
connectionType cloudPcOnPremisesConnectionType Spécifie la méthode par laquelle un PC cloud configuré est joint à Microsoft Entra. L’option azureADJoin indique l’absence d’un Active Directory local (AD) dans le client actuel, ce qui entraîne la jonction du périphérique Cloud PC uniquement à Microsoft Entra. L’option hybridAzureADJoin indique la présence d’un AD local dans le client actuel et que le Cloud PC rejoint à la fois 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 d’attribuer et de se connecter aux utilisateurs cloud uniquement et hybrides, alors qu’elle hybridAzureADJoin est réservée aux utilisateurs hybrides uniquement. La valeur par défaut est hybridAzureADJoin. Les valeurs possibles sont hybridAzureADJoin, azureADJoin, unknownFutureValue.
displayName String Nom complet de la connexion réseau Azure.
healthCheckPaused Booléen Indique si les vérifications d’intégrité régulières de la configuration du réseau ou du domaine sont suspendues ou actives. false si les contrôles d’intégrité réguliers sur la configuration du réseau ou du domaine sont actuellement actifs. true si les vérifications sont interrompues. Si vous effectuez une opération de création ou de mise à jour sur une ressource onPremisesNetworkConnection , cette valeur est définie sur false quatre semaines. Si vous tentez à nouveau une case activée d’intégrité sur la configuration du réseau ou du domaine, cette valeur est définie sur false deux semaines. Si la ressource onPremisesNetworkConnection est attachée dans une ProvisioningPolicy ou utilisée par un Cloud PC au cours des quatre dernières semaines, healthCheckPaused est définie sur false. En lecture seule. La valeur par défaut est false.
healthCheckStatus cloudPcOnPremisesConnectionStatus Status de la dernière case activée d’intégrité effectuée sur la connexion réseau Azure. Par exemple, si le status est passed, la connexion réseau Azure a réussi toutes les vérifications exécutées par le service. Les valeurs possibles sont pending, running, passed, failed, warning, informational, unknownFutureValue. En lecture seule.
healthCheckStatusDetails cloudPcOnPremisesConnectionStatusDetails Détails des vérifications de l’intégrité de la connexion et résultats correspondants. Renvoyé uniquement sur $select. Pour obtenir un exemple qui montre comment obtenir la propriété inUse, consultez Exemple 2 : obtenez les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetails. En lecture seule.
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail Indique les résultats des vérifications de l’intégrité effectuées sur la connexion locale. Renvoyé uniquement sur $select. Pour obtenir un exemple qui montre comment obtenir la propriété inUse, consultez Exemple 2 : obtenez les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetails. En lecture seule.
id String Identificateur unique pour la connexion réseau Azure. En lecture seule.
inUse Booléen Lorsque true, la connexion réseau Azure est utilisée. Lorsque false, la connexion n’est pas utilisée. Vous ne pouvez pas supprimer une connexion en cours d’utilisation. Renvoyé uniquement sur $select. Pour obtenir un exemple qui montre comment obtenir la propriété inUse, consultez Exemple 2 : obtenez les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetails. En lecture seule.
inUseByCloudPc Booléen Indique si un PC cloud utilise cette connexion réseau locale. true si au moins un PC cloud l’utilise. Sinon, false. En lecture seule. La valeur par défaut est false.
managedBy cloudPcManagementService Spécifie les services qui gèrent la connexion réseau Azure. Les valeurs possibles sont windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les membres suivants dans cette énumération évolutive : rpaBox, microsoft365Opal, microsoft365BizChat. En lecture seule.
OrganizationalUnit String Unité d’organisation dans laquelle le compte d’ordinateur est créé. Si elle reste nulle, l’unité d’organisation configurée par défaut (un conteneur d’objets ordinateur bien connu) dans votre domaine Active Directory (OU) est utilisée. Facultatif.
resourceGroupId String ID du groupe de ressources cible. Format obligatoire : /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}.
scopeIds String collection ID d’étendue de l’autorisation correspondante. Actuellement, il s’agit de l’ID de balise d’étendue Intune.
subnetId String ID du sous-réseau cible. Format obligatoire : /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}.
subscriptionId String ID de l’abonnement Azure cible associé à votre client.
nomabonnement String Nom de l’abonnement Azure cible. En lecture seule.
virtualNetworkId String ID du réseau virtuel cible. Format obligatoire : /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}.
virtualNetworkLocation String Indique l’emplacement des ressources du réseau cible virtuel. Valeur calculée en lecture seule.
healthCheckStatusDetails (déconseillé) cloudPcOnPremisesConnectionStatusDetails Indique les vérifications de l’intégrité de la connexion et leurs résultats respectifs. Renvoyé uniquement sur $select. Pour obtenir un exemple qui montre comment obtenir la propriété inUse, consultez Exemple 2 : obtenez les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetails. En lecture seule. La propriété healthCheckStatusDetails est déconseillée et ne renvoie plus de données depuis le 31 janvier 2024. À l’avenir, utilisez la propriété healthCheckStatusDetail .
Type (déconseillé) cloudPcOnPremisesConnectionType Spécifie la méthode par laquelle un PC cloud configuré est joint à Microsoft Entra. L’option azureADJoin indique l’absence d’un Active Directory local (AD) dans le client actuel, ce qui entraîne la jonction du périphérique PC cloud uniquement à Microsoft Entra. L’option hybridAzureADJoin indique la présence d’un AD local dans le client actuel et que le Cloud PC rejoint à la fois 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 d’attribuer et de se connecter aux utilisateurs cloud uniquement et hybrides, alors qu’elle hybridAzureADJoin est réservée aux utilisateurs hybrides uniquement. La valeur par défaut est hybridAzureADJoin. Les valeurs possibles sont hybridAzureADJoin, azureADJoin, unknownFutureValue. La propriété type est déconseillée et ne renvoie plus de données depuis le 31 janvier 2024. Ensuite, utilisez la propriété connectionType .
subnetPrivateIpDetail cloudPcOnPremisesConnectionSubnetIpDetail Contient des informations détaillées sur les adresses IP privées associées au sous-réseau. Renvoyé uniquement sur $select. Pour obtenir un exemple illustrant la procédure de récupération de propriétés spécifiques à l’aide $selectde , reportez-vous à la rubrique Exemple 2 : obtenez les propriétés sélectionnées d’une connexion réseau Azure, notamment healthCheckStatusDetails. En lecture seule.

Valeurs de cloudPcManagementService

Member Description
Windows365 La connexion réseau Azure a été créée avec succès via Windows 365.
DevBox La connexion réseau Azure a été créée avec succès via le projet Fidalgo.
unknownFutureValue Valeur sentinelle d’énumération évolutive. Ne pas utiliser.
rpaBox La connexion réseau Azure a été créée avec succès grâce au projet Power Automate.
microsoft365Opal Indique que la connexion réseau Cloud PC Azure a été créée avec succès via le projet Opal.
microsoft365BizChat Indique que la connexion réseau Cloud PC Azure a été créée avec succès via le Project Biz Chat.

Valeurs cloudPcOnPremisesConnectionType

Member Description
azureADJoin Joint uniquement à Microsoft Entra ID. Les utilisateurs cloud uniquement et hybrides peuvent être affectés et se connecter au PC cloud.
hybridAzureADJoin Joint à Active Directory local et Microsoft Entra ID. Seuls les utilisateurs hybrides peuvent être affectés et se connecter au PC cloud.
unknownFutureValue Valeur sentinelle d’énumération évolutive. Ne pas utiliser.

valeurs cloudPcOnPremisesConnectionStatus

Member Description
a échoué Les vérifications d’intégrité informent le client que la connexion réseau Azure n’est pas configurée ou ne fonctionne pas correctement. Échec de l’approvisionnement. Le client doit identifier le problème et le résoudre à l’aide des conseils fournis par la connexion réseau Azure pour que l’approvisionnement réussisse.
Éléments informatifs Les vérifications d’intégrité fournissent des informations au client sur les vérifications préalables actuelles ou associées sur les fonctionnalités complémentaires de PC cloud, telles que l’authentification unique. Les contrôles d’intégrité informationnels n’affectent pas l’approvisionnement du PC cloud du client. Les informations sont destinées à optimiser l’expérience utilisateur.
Réussite Les vérifications de l’intégrité informent le client que la connexion réseau Azure fonctionne comme prévu. Le client peut provisionner son PC Cloud sans aucun problème.
En attente Créé et en attente de vérifications de l’état.
exécution en cours Les vérifications de l’intégrité sont en cours d’exécution.
unknownFutureValue Valeur sentinelle d’énumération évolutive. Ne pas utiliser.
warning Les vérifications de l’intégrité informent le client que la connexion réseau Azure n’est pas configurée conformément aux recommandations de Microsoft, telles que la connectivité des points de terminaison. Le client doit configurer les points de terminaison requis pour un PC cloud avant de mettre en service un PC cloud. Cela n’affecte pas le provisionnement du PC cloud du client, mais peut affecter l’expérience du client.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subnetPrivateIpDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail" },
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}
  • Last updated on