Tipo de recurso cloudPcOnPremisesConnection
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
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. |
| Actualización de la contraseña de dominio de Active Directory | Ninguno | Actualice la contraseña de dominio de Active Directory para una cloudPcOnPremisesConnection correcta. Esta API se admite cuando el tipo del objeto cloudPcOnPremisesConnection es hybridAzureADJoin. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| adDomainName | Cadena | Nombre de dominio completo (FQDN) del dominio de Active Directory al que desea unirse. Opcional. |
| adDomainPassword | Cadena | Contraseña asociada a adDomainUsername. |
| adDomainUsername | Cadena | Nombre de usuario de una cuenta de Active Directory (cuenta de usuario o servicio) que tiene permisos 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 el método por el que se une un equipo en la nube aprovisionado a Microsoft Entra. La azureADJoin opción indica la ausencia de un Active Directory local (AD) en el inquilino actual que da como resultado que el dispositivo de PC en la nube solo se una a Microsoft Entra. La hybridAzureADJoin opción indica la presencia de un AD local en el inquilino actual y que el equipo en la nube se une a AD local y Microsoft Entra. La opción seleccionada también determina los tipos de usuarios que se pueden asignar y pueden iniciar sesión en un equipo en la nube. La azureADJoin opción permite asignar e iniciar sesión a usuarios híbridos y solo en la nube, mientras que hybridAzureADJoin solo está restringida a los usuarios híbridos. El valor predeterminado es hybridAzureADJoin. Los valores posibles son: hybridAzureADJoin, azureADJoin, unknownFutureValue. |
| 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 de red de Azure. Por ejemplo, si el estado es passed, la conexión de red de Azure pasó todas las comprobaciones ejecutadas por el servicio. Valores posibles: pending, running, passed, failed, warning, informational, unknownFutureValue. Solo lectura. |
| healthCheckStatusDetails | cloudPcOnPremisesConnectionStatusDetails | Los detalles de las comprobaciones de estado de la conexión y los resultados correspondientes. 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 healthCheckStatusDetails. Solo lectura. |
| healthCheckStatusDetails (en desuso) | cloudPcOnPremisesConnectionStatusDetails | Indica las comprobaciones de estado de la conexión y sus resultados respectivos. 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 healthCheckStatusDetails. Solo lectura. La propiedad healthCheckStatusDetails está en desuso y dejó de devolver datos el 31 de enero de 2024. En el futuro, use la propiedad healthCheckStatusDetail . |
| healthCheckStatusDetail | cloudPcOnPremisesConnectionStatusDetail | Indica los resultados de las comprobaciones de estado realizadas en la conexión local. 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 healthCheckStatusDetails. 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 healthCheckStatusDetails. Solo lectura. |
| inUseByCloudPc | Booleano | Indica si un equipo en la nube usa esta conexión de red local.
true si al menos un equipo en la nube lo está usando. De lo contrario, false. Solo lectura. El valor predeterminado es false. |
| healthCheckPaused | Booleano |
false si las comprobaciones de estado normales en la configuración de red o dominio están activas actualmente.
true si las comprobaciones están en pausa. Si realiza una operación de creación o actualización en un recurso onPremisesNetworkConnection , este valor se establece en false durante 4 semanas. Si vuelve a intentar una comprobación de estado en la configuración de red o dominio, este valor se establece en false durante dos semanas. Si el recurso onPremisesNetworkConnection está asociado a provisioningPolicy o lo usa un equipo en la nube en las últimas 4 semanas, healthCheckPaused se establece en false. Solo lectura. El valor predeterminado es false. |
| managedBy | cloudPcManagementService | Especifica qué servicios administran la conexión de red de Azure. Los valores posibles son: windows365, devBox, unknownFutureValue y rpaBox. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener el siguiente valor en esta enumeración evolvable: rpaBox. 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 (OU) de Active Directory. Opcional. |
| 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 (OU) de Active Directory. Opcional. |
| virtualNetworkId | Cadena | Identificador de la red virtual de destino. Formato necesario: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}. |
| virtualNetworkLocation | Cadena | Indica la ubicación del recurso de la red de destino virtual. Valor calculado de solo lectura. |
| resourceGroupId | Cadena | Identificador del grupo de recursos de destino. Formato necesario: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}. |
| subnetId | Cadena | Identificador de la subred de destino. Formato necesario: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}. |
| subscriptionId | Cadena | Identificador de la suscripción de Azure de destino asociada al inquilino. |
| subscriptionName | Cadena | Nombre de la suscripción de Azure de destino. Solo lectura. |
| type (en desuso) | cloudPcOnPremisesConnectionType | Especifica el método por el que se une un equipo en la nube aprovisionado a Microsoft Entra. La azureADJoin opción indica la ausencia de un Active Directory local (AD) en el inquilino actual que da como resultado que el dispositivo de PC en la nube solo se una a Microsoft Entra. La hybridAzureADJoin opción indica la presencia de un AD local en el inquilino actual y que el equipo en la nube se une a AD local y Microsoft Entra. La opción seleccionada también determina los tipos de usuarios que se pueden asignar y pueden iniciar sesión en un equipo en la nube. La azureADJoin opción permite asignar e iniciar sesión a usuarios híbridos y solo en la nube, mientras que hybridAzureADJoin solo está restringida a los usuarios híbridos. El valor predeterminado es hybridAzureADJoin. Los valores posibles son: hybridAzureADJoin, azureADJoin, unknownFutureValue. La propiedad type está en desuso y dejó de devolver datos el 31 de enero de 2024. En el futuro, use la propiedad connectionType . |
valores de cloudPcManagementService
| Member | Descripción |
|---|---|
| devBox | La conexión de red de Azure se creó correctamente a través de Project Fidalgo. |
| rpaBox | La conexión de red de Azure se creó correctamente a través del proyecto de Power Automate. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| windows365 | La conexión de red de Azure se creó correctamente a través de Windows 365. |
valores cloudPcOnPremisesConnectionType
| Member | Descripción |
|---|---|
| azureADJoin | Solo se ha unido a Microsoft Entra ID. Los usuarios híbridos y solo en la nube se pueden asignar e iniciar sesión en el equipo en la nube. |
| hybridAzureADJoin | Unido a Active Directory local y Microsoft Entra ID. Solo se pueden asignar usuarios híbridos e iniciar sesión en el equipo en la nube. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores cloudPcOnPremisesConnectionStatus
| Member | Descripción |
|---|---|
| fracasado | Las comprobaciones de estado notifican al cliente que la conexión de red de Azure no está configurada ni funciona correctamente. Se produce un error en el aprovisionamiento. El cliente debe identificar el problema y resolverlo mediante las instrucciones proporcionadas por la conexión de red de Azure para que el aprovisionamiento se realice correctamente. |
| informativo | Las comprobaciones de estado proporcionan al cliente información sobre 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. Las comprobaciones de estado informativos no afectan al aprovisionamiento del equipo en la nube del cliente. La información está pensada para optimizar la experiencia del usuario. |
| Pasado | Las comprobaciones de estado notifican al cliente que la conexión de red de Azure funciona según lo previsto. El cliente puede aprovisionar su PC en la nube sin ningún problema. |
| pendiente | Creado y esperando comprobaciones de estado. |
| corriente | Las comprobaciones de estado se están ejecutando. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| warning | Las comprobaciones de estado notifican al cliente que la conexión de red de Azure no está configurada según las instrucciones de procedimientos recomendados de Microsoft, como la conectividad de punto de conexión. El cliente debe configurar los puntos de conexión necesarios para el equipo en la nube antes de aprovisionar un equipo en la nube. No afecta al aprovisionamiento del equipo en la nube del cliente, pero puede afectar a la experiencia del cliente. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@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"
}