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 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 | 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. Cette API est prise en charge lorsque le type de l’objet cloudPcOnPremisesConnection est hybridAzureADJoin. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| adDomainName | String | Nom de domaine complet (FQDN) du domaine Active Directory que vous souhaitez joindre. Optional. |
| adDomainPassword | String | Mot de passe associé à adDomainUsername. |
| adDomainUsername | String | 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. Optional. |
| alternateResourceUrl | String | 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 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. |
| displayName | String | Nom complet de la connexion réseau Azure. |
| healthCheckStatus | cloudPcOnPremisesConnectionStatus | La status des case activée d’intégrité les plus récentes effectuées sur la connexion réseau Azure. Par exemple, si le status est passed, la connexion réseau Azure a passé 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 d’intégrité de la connexion et des résultats correspondants. 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 healthCheckStatusDetails. En lecture seule. |
| healthCheckStatusDetails (déconseillé) | cloudPcOnPremisesConnectionStatusDetails | Indique les vérifications d’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 : Obtenir 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 a cessé de retourner des données le 31 janvier 2024. À l’avenir, utilisez la propriété healthCheckStatusDetail . |
| healthCheckStatusDetail | cloudPcOnPremisesConnectionStatusDetail | Indique les résultats des vérifications d’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 : Obtenir les propriétés sélectionnées d’une connexion réseau Azure, y compris healthCheckStatusDetails. En lecture seule. |
| id | String | Identificateur unique de la connexion réseau Azure. En lecture seule. |
| inUse | Boolean | 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 healthCheckStatusDetails. En lecture seule. |
| inUseByCloudPc | Boolean | 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. |
| healthCheckPaused | Boolean |
false si les vérifications d’intégrité régulières sur la configuration du réseau/domaine sont actuellement actives.
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 4 semaines. Si vous réessayez une case activée d’intégrité sur la configuration du réseau/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 4 dernières semaines, healthCheckPaused est définie sur 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 les suivantes : windows365, devBox, unknownFutureValue, rpaBox. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la valeur suivante dans cette énumération évolutive : rpaBox. En lecture seule. |
| OrganizationalUnit | String | Unité d’organisation (UO) dans laquelle le compte d’ordinateur est créé. Si la valeur est laissée null, l’unité d’organisation configurée par défaut (un conteneur d’objets ordinateur connu) dans votre domaine Active Directory (UO) est utilisée. Optional. |
| OrganizationalUnit | String | Unité d’organisation (UO) dans laquelle le compte d’ordinateur est créé. Si la valeur est laissée null, l’unité d’organisation configurée par défaut (un conteneur d’objets ordinateur connu) dans votre domaine Active Directory (UO) est utilisée. Optional. |
| virtualNetworkId | String | ID du réseau virtuel cible. Format requis : /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. |
| resourceGroupId | String | ID du groupe de ressources cible. Format requis : /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}. |
| subnetId | String | ID du sous-réseau cible. Format requis : /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}. |
| subscriptionId | String | ID de l’abonnement Azure cible associé à votre locataire. |
| subscriptionName | String | Nom de l’abonnement Azure cible. En lecture seule. |
| type (déconseillé) | 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. La propriété type est déconseillée et a cessé de retourner des données le 31 janvier 2024. À l’avenir, utilisez la propriété connectionType . |
Valeurs cloudPcManagementService
| Member | Description |
|---|---|
| devBox | La connexion réseau Azure a été créée avec succès via le projet Fidalgo. |
| rpaBox | La connexion réseau Azure a été créée avec succès via le projet Power Automate. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| windows365 | La connexion réseau Azure a été créée avec succès via Windows 365. |
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 sentinel de l’énumération évolutive. Ne pas utiliser. |
Valeurs cloudPcOnPremisesConnectionStatus
| Member | Description |
|---|---|
| raté | Les contrôles d’intégrité informent le client que la connexion réseau Azure n’est pas correctement configurée ou ne fonctionne pas correctement. L’approvisionnement échoue. Le client doit identifier le problème et le résoudre à l’aide des instructions fournies par la connexion réseau Azure pour que le provisionnement réussisse. |
| informationnel | Les contrôles d’intégrité fournissent au client des informations sur les vérifications actuelles ou associées des prérequis sur les fonctionnalités de module complémentaire PC cloud, telles que l’authentification unique. Les contrôles d’intégrité d’information n’affectent pas l’approvisionnement du PC cloud du client. Les informations sont destinées à optimiser l’expérience utilisateur. |
| Passé | Les contrôles d’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 instance | Créé et en attente de contrôles d’intégrité. |
| course | Les contrôles d’intégrité sont en cours d’exécution. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| warning | Les contrôles d’intégrité informent le client que la connexion réseau Azure n’est pas configurée conformément aux bonnes pratiques de Microsoft, telles que la connectivité des points de terminaison. Le client doit configurer les points de terminaison requis du PC cloud avant de provisionner un PC cloud. Cela n’affecte pas l’approvisionnement 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",
"healthCheckStatus": "String",
"healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
"healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
"id": "String (identifier)",
"inUse": "Boolean",
"inUseByCloudPc": "Boolean",
"healthCheckPaused": "Boolean",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}