Type de ressource cloudPcOnPremisesConnection

Espace de noms: microsoft.graph

Représente une collection définie d’informations de ressources Azure qui peuvent être utilisées pour établir Azure connectivité réseau pour les PC cloud.

Importante

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

Méthodes

Méthode	Type de retour	Description
List	collection cloudPcOnPremisesConnection	Répertorie 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	Aucune	Supprime un objet cloudPcOnPremisesConnection . Vous ne pouvez pas supprimer une connexion en cours d’utilisation.
Exécuter des contrôles d’intégrité	Aucune	Exécutez des vérifications d’intégrité sur cloudPcOnPremisesConnection.
Mettre à jour le mot de passe de domaine Active Directory	Aucune	Mettez à jour le mot de passe de domaine Active Directory pour que cloudPcOnPremisesConnection réussisse.

Propriétés

Propriété	Type	Description
adDomainName	String	Nom de domaine complet (FQDN) du domaine Active Directory que vous souhaitez joindre. La longueur maximale est de 255. Facultatif.
adDomainPassword	String	Mot de passe associé au nom d’utilisateur d’un compte Active Directory (adDomainUsername).
adDomainUsername	String	Nom d’utilisateur d’un compte Active Directory (compte d’utilisateur ou de service) qui est autorisé à créer des objets ordinateur dans Active Directory. Format requis : admin@contoso.com. Facultatif.
alternateResourceUrl	String	URL d’interface de la ressource du service partenaire qui établit un lien vers cette Azure connexion réseau. Nécessite $select la récupération.
connectionType	cloudPcOnPremisesConnectionType	Spécifie la façon dont le PC cloud approvisionné se joint à Microsoft Entra. Il comprend différents types, l’un est Microsoft Entra ID jointure, ce qui signifie qu’il n’y a pas de Active Directory local (AD) dans le locataire actuel et que l’appareil PC cloud est joint par Microsoft Entra. Un autre est hybrideAzureADJoin, ce qui signifie qu’il existe également un Active Directory local (AD) dans le locataire actuel et que l’appareil PC cloud se joint à Active Directory local (AD) et Microsoft Entra. Le type détermine également les types d’utilisateurs qui peuvent être affectés et peuvent se connecter à un PC cloud. Le type azureADJoin indique que les utilisateurs cloud uniquement et hybrides peuvent être affectés et connectés au PC cloud. hybridAzureADJoin indique que seuls les utilisateurs hybrides peuvent être affectés et connectés au PC cloud. La valeur par défaut est hybridAzureADJoin.
displayName	String	Nom complet de la connexion réseau Azure.
healthCheckPaused	Booléen	Indique si les contrôles d’intégrité réguliers sur la configuration du réseau ou du domaine sont suspendus ou actifs. 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 suspendues. Si vous effectuez une opération de création ou de mise à jour sur une ressource onPremisesNetworkConnection , cette valeur est définie sur false pendant quatre semaines. Si vous réessayez une case activée d’intégrité sur la configuration du réseau ou du domaine, cette valeur est définie sur false pendant deux semaines. Si la ressource onPremisesNetworkConnection est attachée dans une provisioningPolicy ou utilisée par un PC cloud 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	La status de la case activée d’intégrité la plus récente effectuée sur la connexion locale. Par exemple, si le status est passed, la connexion locale a passé toutes les vérifications exécutées par le service. Valeurs possibles : pending, running, passed, failed, warning, informational. La valeur par défaut est pending. En lecture seule.
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Indique les résultats des vérifications d’intégrité effectuées sur la connexion locale. En lecture seule. Nécessite $select la récupération. Pour obtenir un exemple qui montre comment obtenir la propriété inUse, consultez Exemple 2 : Obtenir les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetail. En lecture seule.
id	String	Identificateur unique de la connexion réseau Azure. En lecture seule.
Inuse	Booléen	Quand truela valeur est , la connexion réseau Azure est en cours d’utilisation. Quand falsela valeur est , 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 : Obtenir les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetail. 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.
OrganizationalUnit	String	Unité d’organisation (UO) dans laquelle le compte d’ordinateur est créé. Si la valeur est null, l’unité d’organisation configurée par défaut (un conteneur d’objets ordinateur connu) dans le domaine Active Directory (UO) du locataire est utilisée. Facultatif.
resourceGroupId	String	Identificateur unique du groupe de ressources cible utilisé associé à la connectivité réseau locale pour les PC cloud. Format requis : « /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	Identificateur unique du sous-réseau cible utilisé associé à la connectivité réseau locale pour les PC cloud. Format requis : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName} »
subscriptionId	String	Identificateur unique de l’abonnement Azure associé au locataire.
subscriptionName	String	Le nom de l’abonnement Azure est utilisé pour créer une connexion réseau Azure. En lecture seule.
virtualNetworkId	String	Identificateur unique du réseau virtuel cible utilisé associé à la connectivité réseau locale pour les PC cloud. Format requis : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName} »
virtualNetworkLocation	String	Indique l’emplacement des ressources du réseau virtuel cible. Par exemple, l’emplacement peut être eastus2, westeurope, etc. En lecture seule (valeur calculée).

Valeurs cloudPcOnPremisesConnectionType

Member	Description
azureADJoin	Indique que les appareils PC cloud sont joints uniquement à Microsoft Entra ID.
hybridAzureADJoin	Indique que les appareils PC cloud sont joints à Active Directory local et inscrits auprès de Microsoft Entra ID.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Valeurs cloudPcOnPremisesConnectionStatus

Member	Description
Échoué	Indique que les vérifications d’intégrité de la connexion réseau Azure pc cloud sont maintenant terminées, avec des échecs. L’environnement du client n’est pas correctement configuré, ce qui entraîne une défaillance de l’approvisionnement du PC cloud. Le client doit identifier le problème et le résoudre à l’aide des instructions fournies par la connexion locale pour le provisionnement.
Information	Indique que les vérifications de l’intégrité de la connexion réseau Azure pc cloud sont maintenant terminées, avec des informations de case activée d’intégrité. Les contrôles d’intégrité fournissent aux clients des informations sur les vérifications actuelles ou associées des prérequis status sur les fonctionnalités de module complémentaire PC cloud, telles que l’authentification unique. Cela n’affecte pas l’approvisionnement des PC cloud de nos clients, mais vise à optimiser l’expérience utilisateur.
Passé	Indique que les vérifications d’intégrité de la connexion réseau Azure pc cloud sont terminées et passées. Le client peut provisionner son PC cloud sans aucun problème.
Attente	Valeur par défaut. Indique que l’case activée d’intégrité de la connexion réseau Azure pc cloud est lancée et en attente d’achèvement.
Exécution	Indique que les vérifications d’intégrité de la connexion réseau Azure pc cloud sont toujours en cours d’exécution.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.
warning	Indique que les vérifications d’intégrité de la connexion réseau Azure pc cloud sont maintenant terminées, avec des échecs. L’environnement du client n’est pas correctement configuré, ce qui entraîne une défaillance de l’approvisionnement du PC cloud. Le client doit identifier le problème et le résoudre à l’aide des instructions fournies par la connexion locale pour le provisionnement.

Relations

Aucun.

Représentation JSON

L’exemple suivant 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" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "virtualNetworkId": "String"
}