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 conectividad de red de Azure para PC en la nube.

Importante

El nombre de la conexión de red local ha cambiado a 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 Enumerar las propiedades y las relaciones de los objetos cloudPcOnPremisesConnection .
Get cloudPcOnPremisesConnection Lea las propiedades y las 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.
Ejecutar comprobaciones de estado Ninguno Ejecute comprobaciones de estado en cloudPcOnPremisesConnection.
Actualizar contraseña de dominio de Active Directory Ninguno Actualice la contraseña de dominio de Active Directory para obtener una cloudPcOnPremisesConnection correcta.

Propiedades

Propiedad Tipo Descripción
adDomainName Cadena El nombre de dominio completo (FQDN) del dominio de Active Directory al que desea unirse. Opcional.
adDomainPassword Cadena La 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 requerido: admin@contoso.com. Opcional.
alternateResourceUrl Cadena La dirección URL de la interfaz del recurso del servicio asociado que se vincula a esta conexión de red de Azure. Requiere $select recuperarse.
connectionType cloudPcOnPremisesConnectionType Especifica el método por el que se une un PC en la nube aprovisionado a Microsoft Entra. La azureADJoin opción indica la ausencia de un Active Directory local (AD) en el inquilino actual, lo que hace que el dispositivo 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 PC en la nube se une tanto al AD local como a Microsoft Entra. La opción seleccionada también determina los tipos de usuarios que se pueden asignar y pueden iniciar sesión en un PC en la nube. La azureADJoin opción permite que los usuarios híbridos y de nube se asignen e inicien sesión, mientras que hybridAzureADJoin está restringida solo a usuarios híbridos. El valor predeterminado es hybridAzureADJoin. Los valores posibles son: hybridAzureADJoin, azureADJoin, unknownFutureValue.
displayName Cadena El nombre para mostrar de la conexión de red de Azure.
healthCheckPaused Booleano Indica si las comprobaciones de estado periódicas en la configuración de red o dominio están en pausa o activas. false Si las comprobaciones de estado periódicas en la configuración de red o dominio están activas actualmente. true si se pausan las comprobaciones. 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 establecerá en false durante dos semanas. Si el recurso onPremisesNetworkConnection está asociado en una directiva de aprovisionamiento o lo usó un PC en la nube en las últimas cuatro semanas, healthCheckPaused se establece en false. Solo lectura. El valor predeterminado es false.
healthCheckStatus cloudPcOnPremisesConnectionStatus El 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. Los valores posibles son: pending, running, passed, failed, warning, informational y 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 ver un ejemplo que muestra cómo obtener la propiedad inUse, vea el ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetails. Solo lectura.
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail Indica los resultados de las comprobaciones de estado realizadas en la conexión local. Solo se devuelve en $select. Para ver un ejemplo que muestra cómo obtener la propiedad inUse, vea el ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetails. Solo lectura.
id Cadena Identificador único para la conexión de red de Azure. Solo lectura.
en uso Booleano Cuando true, la conexión de red de Azure está en uso. Cuando false, la conexión no está en uso. No se puede eliminar una conexión que está en uso. Solo se devuelve en $select. Para ver un ejemplo que muestra cómo obtener la propiedad inUse, vea el ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetails. Solo lectura.
inUseByCloudPc Booleano Indica si un PC en la nube está usando esta conexión de red local. true si al menos un PC en la nube lo está usando. De lo contrario, 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, rpaBox, microsoft365Opal, microsoft365BizChat. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes miembros en esta enumeración evolutiva: rpaBox, microsoft365Opal, microsoft365BizChat. Solo lectura.
organizationalUnit Cadena La unidad organizativa (OU) en la que se crea la cuenta informática. Si se deja null, se usa la unidad organizativa configurada como predeterminada (un contenedor de objetos de equipo conocidos) en el dominio de Active Directory (OU). Opcional.
resourceGroupId Cadena Id. del grupo de recursos de destino. Formato requerido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}.
scopeIds Colección string Identificadores de ámbito del permiso correspondiente. Actualmente, es el identificador de etiqueta de ámbito de Intune.
subnetId Cadena Id. de la subred de destino. Formato requerido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}.
subscriptionId Cadena El identificador de la suscripción de Azure de destino asociada a su inquilino.
subscriptionName Cadena Nombre de la suscripción de Azure de destino. Solo lectura.
virtualNetworkId Cadena Id. de la red virtual de destino. Formato requerido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}.
virtualNetworkLocation Cadena Indica la ubicación de recursos de la red virtual de destino. Valor calculado de solo lectura.
healthCheckStatusDetails (obsoleto) cloudPcOnPremisesConnectionStatusDetails Indica las comprobaciones de mantenimiento de la conexión y sus resultados respectivos. Solo se devuelve en $select. Para ver un ejemplo que muestra cómo obtener la propiedad inUse, vea el 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. De ahora en adelante, usa la propiedad healthCheckStatusDetail .
Tipo (en desuso) cloudPcOnPremisesConnectionType Especifica el método por el que se une un PC en la nube aprovisionado a Microsoft Entra. La azureADJoin opción indica la ausencia de un Active Directory local (AD) en el inquilino actual, lo que da como resultado que el dispositivo 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 PC en la nube se une tanto al AD local como a Microsoft Entra. La opción seleccionada también determina los tipos de usuarios que se pueden asignar y pueden iniciar sesión en un PC en la nube. La azureADJoin opción permite que los usuarios híbridos y de nube se asignen e inicien sesión, mientras que hybridAzureADJoin está restringida solo a usuarios híbridos. El valor predeterminado es hybridAzureADJoin. Los valores posibles son: hybridAzureADJoin, azureADJoin, unknownFutureValue. La propiedad type quedó en desuso y dejó de devolver datos el 31 de enero de 2024. De ahora en adelante, usa la propiedad connectionType .
subnetPrivateIpDetail cloudPcOnPremisesConnectionSubnetIpDetail Contiene información detallada sobre las direcciones IP privadas asociadas a la subred. Solo se devuelve en $select. Para ver un ejemplo que muestra cómo recuperar propiedades específicas mediante $select, consulte Ejemplo 2: Obtener las propiedades seleccionadas de una conexión de red de Azure, incluido healthCheckStatusDetails. Solo lectura.

valores de cloudPcManagementService

Member Descripción
Windows365 La conexión de red de Azure se creó correctamente mediante Windows 365.
Caja de datos La conexión de red de Azure se creó correctamente a través de Project Fidalgo.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.
rpaBox La conexión de red de Azure se creó correctamente mediante el proyecto Power Automate.
microsoft365Opal Indica que la conexión de red de Cloud PC Azure se creó correctamente a través de Project Opal.
microsoft365BizChat Indica que la conexión de red de Azure para PC en la nube se creó correctamente a través de Project Biz Chat.

valores cloudPcOnPremisesConnectionType

Member Descripción
azureADJoin Unido solo a Microsoft Entra ID. Los usuarios híbridos y solo en la nube se pueden asignar e iniciar sesión en el PC en la nube.
hybridAzureADJoin Unido a Active Directory local y a Microsoft Entra ID. Solo se pueden asignar usuarios híbridos e iniciar sesión en el PC en la nube.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

valores de cloudPcOnPremisesConnectionStatus

Member Descripción
con errores Las comprobaciones de mantenimiento notifican al cliente que la conexión de red de Azure no está configurada o no funciona correctamente. Error de aprovisionamiento. El cliente debe identificar el problema y resolverlo siguiendo las instrucciones proporcionadas por la conexión de red de Azure para que el aprovisionamiento se realice correctamente.
Informativo. Las comprobaciones de estado proporcionan información al cliente 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 informativas no afectan al aprovisionamiento del PC en la nube del cliente. La información está destinada a optimizar la experiencia del usuario.
Aprobado Las comprobaciones de mantenimiento 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 las comprobaciones de estado.
en ejecución Se están ejecutando las comprobaciones de estado.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.
warning Las comprobaciones de mantenimiento 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 puntos de conexión. El cliente debe configurar los puntos de conexión necesarios para el PC en la nube antes de aprovisionar un PC en la nube. No afecta al aprovisionamiento del PC 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",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subnetPrivateIpDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail" },
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}
  • Last updated on