Tipo de recurso cloudPcOnPremisesConnection

Artículo
04/01/2024

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
Enumeración de onPremisesConnections	colección cloudPcOnPremisesConnection	Enumera las propiedades y relaciones de los objetos cloudPcOnPremisesConnection .
Obtención de cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Lea las propiedades y relaciones del objeto cloudPcOnPremisesConnection .
Creación de cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Cree un nuevo objeto cloudPcOnPremisesConnection .
Actualización de cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Actualice las propiedades de un objeto cloudPcOnPremisesConnection .
Eliminación de cloudPcOnPremisesConnection	Ninguno	Elimine un objeto cloudPcOnPremisesConnection . No se puede eliminar una conexión que esté en uso.
RunHealthChecks de cloudPcOnPremisesConnection	Ninguno	Ejecute comprobaciones de estado en cloudPcOnPremisesConnection.
updateAdDomainPassword	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. Siga adelante, 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 `true`es , la conexión de red de Azure está en uso. Cuando `false`es , 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.
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 los siguientes valores 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. Siga adelante, 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
Fallado	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. Esto no afectará al aprovisionamiento del equipo en la nube del cliente, pero 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.
Corriendo	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",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}