Tipo de recurso cloudPcOnPremisesConnection
Espacio de nombres: microsoft.graph
Representa una colección definida de información de recursos de Azure que se puede usar para establecer la conectividad de red de Azure para equipos en la nube.
Importante
Se ha cambiado el nombre de la conexión de red local como conexión de red de Azure. Los objetos cloudPcOnPremisesConnection son equivalentes a la conexión de red de Azure para el producto cloud pc.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | colección cloudPcOnPremisesConnection | Enumera las propiedades y relaciones de los objetos cloudPcOnPremisesConnection . |
| Get | cloudPcOnPremisesConnection | Lea las propiedades y relaciones del objeto cloudPcOnPremisesConnection . |
| Crear | cloudPcOnPremisesConnection | Cree un nuevo objeto cloudPcOnPremisesConnection . |
| Actualizar | cloudPcOnPremisesConnection | Actualice las propiedades de un objeto cloudPcOnPremisesConnection . |
| Delete | Ninguno | Elimine un objeto cloudPcOnPremisesConnection . No se puede eliminar una conexión que esté en uso. |
| Ejecución de comprobaciones de estado | Ninguno | Ejecute comprobaciones de estado en cloudPcOnPremisesConnection. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| adDomainName | Cadena | Nombre de dominio completo (FQDN) del dominio de Active Directory al que desea unirse. La longitud máxima es de 255. Opcional. |
| adDomainPassword | Cadena | Contraseña asociada al nombre de usuario de una cuenta de Active Directory (adDomainUsername). |
| adDomainUsername | Cadena | Nombre de usuario de una cuenta de Active Directory (cuenta de usuario o servicio) que tiene permiso para crear objetos de equipo en Active Directory. Formato necesario: admin@contoso.com. Opcional. |
| alternateResourceUrl | Cadena | Dirección URL de la interfaz del recurso del servicio asociado que se vincula a esta conexión de red de Azure. Solo se devuelve en $select. |
| connectionType | cloudPcOnPremisesConnectionType | Especifica cómo se une el equipo en la nube aprovisionado a Microsoft Entra. Incluye tipos diferentes, uno es Microsoft Entra ID unión, lo que significa que no hay ningún Active Directory local (AD) en el inquilino actual y el dispositivo de PC en la nube se une a Microsoft Entra. Otro es hybridAzureADJoin, lo que significa que también hay un Active Directory local (AD) en el inquilino actual y el dispositivo de PC en la nube se une a Active Directory local (AD) y Microsoft Entra. El tipo también determina qué tipos de usuarios se pueden asignar y pueden iniciar sesión en un equipo en la nube. El tipo azureADJoin indica que los usuarios híbridos y solo en la nube se pueden asignar e iniciar sesión en el equipo en la nube. hybridAzureADJoin indica que solo se pueden asignar usuarios híbridos e iniciar sesión en el equipo en la nube. El valor predeterminado es hybridAzureADJoin. |
| displayName | Cadena | Nombre para mostrar de la conexión de red de Azure. |
| healthCheckStatus | cloudPcOnPremisesConnectionStatus | Estado de la comprobación de estado más reciente realizada en la conexión local. Por ejemplo, si el estado es passed, la conexión local pasó todas las comprobaciones ejecutadas por el servicio. Valores posibles: pending, running, passed, failed, , warning. informational El valor predeterminado es pending. Solo lectura. |
| healthCheckStatusDetail | cloudPcOnPremisesConnectionStatusDetail | Indica los resultados de las comprobaciones de estado realizadas en la conexión local. Solo lectura. Solo se devuelve en $select. Para obtener un ejemplo que muestra cómo obtener la propiedad inUse , consulte Ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetail. Solo lectura. |
| id | Cadena | Identificador único de la conexión de red de Azure. Solo lectura. |
| inUse | Booleano | Cuando truees , la conexión de red de Azure está en uso. Cuando falsees , la conexión no está en uso. No se puede eliminar una conexión que esté en uso. Solo se devuelve en $select. Para obtener un ejemplo que muestra cómo obtener la propiedad inUse , consulte Ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetail. Solo lectura. |
| organizationalUnit | Cadena | Unidad organizativa (UO) en la que se crea la cuenta de equipo. Si se deja null, se usa la unidad organizativa configurada como predeterminada (un contenedor de objetos de equipo conocido) en el dominio de Active Directory (OU) del inquilino. Opcional. |
| resourceGroupId | Cadena | Identificador único del grupo de recursos de destino que se usa asociado a la conectividad de red local para equipos en la nube. Formato necesario: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}" |
| subnetId | Cadena | Identificador único de la subred de destino que se usa asociada a la conectividad de red local para equipos en la nube. Formato necesario: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}" |
| subscriptionId | Cadena | Identificador único de la suscripción de Azure asociada al inquilino. |
| subscriptionName | Cadena | El nombre de la suscripción de Azure se usa para crear una conexión de red de Azure. Solo lectura. |
| virtualNetworkId | Cadena | Identificador único de la red virtual de destino que se usa asociada a la conectividad de red local para equipos en la nube. Formato necesario: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}" |
| virtualNetworkLocation | Cadena | Indica la ubicación del recurso de la red virtual de destino. Por ejemplo, la ubicación puede ser eastus2, westeurope, etc. Solo lectura (valor calculado). |
valores cloudPcOnPremisesConnectionType
| Member | Descripción |
|---|---|
| azureADJoin | Indica que los dispositivos de PC en la nube solo se unen a Microsoft Entra ID. |
| hybridAzureADJoin | Indica que los dispositivos de PC en la nube se unen a Active Directory local y se registran con Microsoft Entra ID. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores cloudPcOnPremisesConnectionStatus
| Member | Descripción |
|---|---|
| fracasado | Indica que las comprobaciones de estado de la conexión de red de Azure del equipo en la nube ya se han completado, con errores. El entorno del cliente no está configurado correctamente, lo que provoca un error en el aprovisionamiento del equipo en la nube. El cliente debe identificar el problema y resolverlo mediante las instrucciones proporcionadas por la conexión local para el aprovisionamiento correctamente. |
| informativo | Indica que las comprobaciones de estado de la conexión de red de Azure del equipo en la nube ya se han completado, con información de comprobación de estado. Las comprobaciones de estado proporcionan información a los clientes sobre el estado de las comprobaciones de requisitos previos actuales o asociadas en las características del complemento de PC en la nube, como el inicio de sesión único. No afecta al aprovisionamiento de los equipos en la nube de nuestros clientes, pero pretende optimizar la experiencia del usuario. |
| Pasado | Indica que las comprobaciones de estado de la conexión de red de Azure del equipo en la nube se completan y pasan. El cliente puede aprovisionar su PC en la nube sin ningún problema. |
| pendiente | Valor predeterminado. Indica que la comprobación de estado de la conexión de red de Azure del equipo en la nube se inicia y espera a su finalización. |
| corriente | Indica que las comprobaciones de estado de la conexión de red de Azure del equipo en la nube siguen ejecutándose. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| warning | Indica que las comprobaciones de estado de la conexión de red de Azure del equipo en la nube ya se han completado, con errores. El entorno del cliente no está configurado correctamente, lo que provoca un error en el aprovisionamiento del equipo en la nube. El cliente debe identificar el problema y resolverlo mediante las instrucciones proporcionadas por la conexión local para el aprovisionamiento correctamente. |
Relaciones
Ninguna.
Representación JSON
En el ejemplo siguiente se muestra el tipo de recurso.
{
"@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"
}