Tipo de recurso cloudPcOnPremisesConnection

Espacio de nombres: microsoft.graph

Representa una colección definida de Azure información de recursos que se puede usar para establecer Azure conectividad de red para equipos en la nube.

Importante

Se ha cambiado el nombre de la conexión de red local como Azure conexión de red. Los objetos cloudPcOnPremisesConnection son equivalentes a Azure conexión de red para el producto pc en la nube.

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 del dominio de Active Directory para una cloudPcOnPremisesConnection correcta.

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 interfaz del recurso del servicio asociado que se vincula a este Azure conexión de red. Requiere $select recuperarlo.
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 Azure.
healthCheckPaused Booleano Indica si las comprobaciones de estado normales en la configuración de red o dominio están en pausa o activas. false si el estado normal comprueba si la configuración de red o dominio está activa 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 cuatro 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 cuatro semanas, healthCheckPaused se establece en false. Solo lectura. El valor predeterminado es false.
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. Requiere $select recuperarlo. Para obtener un ejemplo que muestra cómo obtener la propiedad inUse, vea Ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red Azure, incluido healthCheckStatusDetail. Solo lectura.
id Cadena Identificador único de la conexión de red Azure. Solo lectura.
inUse Booleano Cuando true, la conexión de red 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, vea Ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red Azure, incluido healthCheckStatusDetail. 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.
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}"
scopeIds Colección string Identificadores de ámbito del permiso correspondiente. Actualmente, es el identificador de la etiqueta de ámbito de Intune.
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 Azure asociada al inquilino.
subscriptionName Cadena El nombre de la suscripción Azure se usa para crear una conexión de red 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
error Indica que el equipo en la nube Azure las comprobaciones de estado de la conexión de red 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 el equipo en la nube Azure las comprobaciones de estado de conexión de red 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 el equipo en la nube Azure las comprobaciones de estado de la conexión de red se completan y pasan. El cliente puede aprovisionar su PC en la nube sin ningún problema.
pendiente Valor predeterminado. Indica que el equipo en la nube Azure se inicia la comprobación de estado de la conexión de red y espera a su finalización.
en ejecución Indica que el equipo en la nube Azure las comprobaciones de estado de la conexión de red siguen ejecutándose.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.
warning Indica que el equipo en la nube Azure las comprobaciones de estado de la conexión de red 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",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "virtualNetworkId": "String"
}
  • Last updated on