Type de ressource cloudPcOnPremisesConnection

Article
04/22/2024

Espace de noms: microsoft.graph

Représente une collection définie 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 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	Create un nouvel 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.

Propriétés

Propriété	Type	Description
adDomainName	Chaîne	Nom de domaine complet (FQDN) du domaine Active Directory que vous souhaitez joindre. La longueur maximale est de 255. Optional.
adDomainPassword	Chaîne	Mot de passe associé au nom d’utilisateur d’un compte Active Directory (adDomainUsername).
adDomainUsername	Chaîne	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`. Optional.
alternateResourceUrl	Chaîne	URL d’interface de la ressource du service partenaire liée à cette connexion réseau Azure. Renvoyé uniquement sur `$select`.
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	Chaîne	Nom complet de la connexion réseau Azure.
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. 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.
id	Chaîne	Identificateur unique de la connexion réseau Azure. En lecture seule.
Inuse	Valeur booléenne	Quand `true`la valeur est , la connexion réseau Azure est en cours d’utilisation. Quand `false`la 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.
OrganizationalUnit	Chaîne	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. Optional.
resourceGroupId	Chaîne	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} »
subnetId	Chaîne	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	Chaîne	Identificateur unique de l’abonnement Azure associé au locataire.
subscriptionName	Chaîne	Le nom de l’abonnement Azure est utilisé pour créer une connexion réseau Azure. En lecture seule.
virtualNetworkId	Chaîne	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	Chaîne	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 d’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 du 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’intégrité de la connexion réseau Azure du PC cloud case activée 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 du 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

Voici un exemple de type de ressource.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": {
    "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail",
    "endDateTime": "String (timestamp)",
    "healthChecks": [
      {
        "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
        "additionalDetail": "String",
        "displayName": "String",
        "endDateTime": "String (timestamp)",
        "errorType": "String",
        "recommendedAction": "String",
        "correlationId": "String",
        "startDateTime": "String (timestamp)",
        "status": "String"
      }
    ],
    "startDateTime": "String (timestamp)"
  },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "connnecetionType": "String",
  "virtualNetworkId": "String"
}

Partager via