Tipo de recurso cloudPcOnPremisesConnection

Artículo
03/27/2024

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
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.

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 `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 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
Fallado	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.
Corriendo	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

A continuación se muestra un ejemplo del 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"
}