cloudPcOnPremisesConnection tipo de recurso

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma coleção definida de informações de recursos do Azure que podem ser usadas para estabelecer a conectividade de rede do Azure para computadores na nuvem.

Importante

A conexão de rede local foi renomeada como conexão de rede do Azure. Os objetos cloudPcOnPremisesConnection aqui são equivalentes à conexão de rede do Azure para o produto Cloud PC.

Métodos

Método Tipo de retorno Descrição
List Coleção cloudPcOnPremisesConnection Listar propriedades e relações dos objetos cloudPcOnPremisesConnection .
Get cloudPcOnPremisesConnection Leia as propriedades e relações do objeto cloudPcOnPremisesConnection .
Create cloudPcOnPremisesConnection Crie um novo objeto cloudPcOnPremisesConnection .
Atualizar cloudPcOnPremisesConnection Atualizar as propriedades de um objeto cloudPcOnPremisesConnection .
Delete Nenhum Exclua um objeto cloudPcOnPremisesConnection . Não é possível excluir uma conexão que está em uso.
Executar verificações de integridade Nenhum Execute verificações de integridade no cloudPcOnPremisesConnection.
Atualizar senha de domínio do Active Directory Nenhum Atualize a senha de domínio do Active Directory para uma cloudPcOnPremisesConnection bem-sucedida.

Propriedades

Propriedade Tipo Descrição
adDomainName Cadeia de caracteres O FQDN (nome de domínio totalmente qualificado) do domínio do Active Directory ao qual você deseja ingressar. Opcional.
adDomainPassword Cadeia de caracteres A senha associada ao adDomainUsername.
adDomainUsername Cadeia de caracteres O nome de usuário de uma conta do Active Directory (conta de usuário ou serviço) que tem permissões para criar objetos de computador no Active Directory. Formato exigido: admin@contoso.com. Opcional.
alternateResourceUrl Cadeia de caracteres A URL de interface do recurso do serviço do parceiro vinculado a essa conexão de rede do Azure. Requer $select recuperação.
connectionType cloudPcOnPremisesConnectionType Especifica o método pelo qual um PC na nuvem provisionado é associado ao Microsoft Entra. A azureADJoin opção indica a ausência de um Active Directory local (AD) no locatário atual, o que resulta no ingresso do dispositivo Cloud PC apenas no Microsoft Entra. A hybridAzureADJoin opção indica a presença de um AD local no locatário atual e que o PC na nuvem ingressa no AD local e no Microsoft Entra. A opção selecionada também determina os tipos de usuários que podem ser atribuídos e podem entrar em um PC na nuvem. A azureADJoin opção permite que usuários somente em nuvem e híbridos sejam atribuídos e entrem, enquanto hybridAzureADJoin é restrita apenas a usuários híbridos. O valor padrão é hybridAzureADJoin. Os valores possíveis são: hybridAzureADJoin, azureADJoin, unknownFutureValue.
displayName Cadeia de caracteres O nome de exibição da conexão de rede do Azure.
healthCheckPaused Booliano Indica se as verificações de integridade regulares na rede ou na configuração de domínio estão pausadas ou ativas. false se as verificações de integridade regulares na rede ou na configuração de domínio estão ativas no momento. true se as verificações forem pausadas. Se você executar uma operação de criação ou atualização em um recurso onPremisesNetworkConnection , esse valor será definido como false por quatro semanas. Se você tentar uma nova marca de integridade na configuração de rede ou domínio, esse valor será definido como false por duas semanas. Se o recurso onPremisesNetworkConnection estiver anexado a uma provisioningPolicy ou usado por um PC na nuvem nas últimas quatro semanas, healthCheckPaused está definido como false. Somente leitura. O padrão é false.
healthCheckStatus cloudPcOnPremisesConnectionStatus O status da marca de integridade mais recente feita na conexão de rede do Azure. Por exemplo, se o status for passed, a conexão de rede do Azure passou em todas as verificações executadas pelo serviço. Os valores possíveis são pending, running, passed, failed, warning, informational, unknownFutureValue. Somente leitura.
healthCheckStatusDetails cloudPcOnPremisesConnectionStatusDetails Os detalhes das verificações de integridade da conexão e os resultados correspondentes. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse, consulte o Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail Indica os resultados das verificações de integridade executadas na conexão local. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse, consulte o Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
id Cadeia de caracteres Identificador exclusivo da conexão de rede do Azure. Somente leitura.
em uso Booliano Quando true, a conexão de rede do Azure está em uso. Quando false, a conexão não está em uso. Não é possível excluir uma conexão que está em uso. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse, consulte o Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
inUseByCloudPc Booliano Indica se um PC na nuvem está usando essa conexão de rede local. true se pelo menos um PC na nuvem o estiver usando. Caso contrário, false. Somente leitura. O padrão é false.
managedBy cloudPcManagementService Especifica quais serviços gerenciam a conexão de rede do Azure. Os valores possíveis são: windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes membros nesta enumeração evolutiva: rpaBox, microsoft365Opal, microsoft365BizChat. Somente leitura.
organizationalUnit Cadeia de caracteres A unidade organizacional (OU) na qual a conta de computador é criada. Se for deixada nula, a UO configurada como padrão (um contêiner de objeto de computador conhecido) no domínio da UO (OU) do Active Directory será usada. Opcional.
resourceGroupId Cadeia de caracteres A ID do grupo de recursos de destino. Formato exigido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}.
scopeIds String collection As IDs de escopo da permissão correspondente. Atualmente, é a ID da marca de escopo do Intune.
Id de sub-rede Cadeia de caracteres A ID da sub-rede de destino. Formato exigido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}.
subscriptionId Cadeia de caracteres A ID da assinatura do Azure de destino associada ao seu locatário.
Nome da assinatura Cadeia de caracteres O nome da assinatura do Azure de destino. Somente leitura.
virtualNetworkId Cadeia de caracteres A ID da rede virtual de destino. Formato exigido: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}.
virtualNetworkLocation Cadeia de caracteres Indica a localização do recurso da rede de destino virtual. Valor computado somente leitura.
healthCheckStatusDetails (preterido) cloudPcOnPremisesConnectionStatusDetails Indica as verificações de integridade para a conexão e seus respectivos resultados. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse, consulte o Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura. A propriedade healthCheckStatusDetails foi preterida e parou de retornar dados em 31 de janeiro de 2024. No futuro, use a propriedade healthCheckStatusDetail .
Tipo (preterido) cloudPcOnPremisesConnectionType Especifica o método pelo qual um PC na nuvem provisionado é associado ao Microsoft Entra. A azureADJoin opção indica a ausência de um Active Directory local (AD) no locatário atual, o que resulta no dispositivo PC na nuvem ingressando apenas no Microsoft Entra. A hybridAzureADJoin opção indica a presença de um AD local no locatário atual e que o PC na nuvem ingressa no AD local e no Microsoft Entra. A opção selecionada também determina os tipos de usuários que podem ser atribuídos e podem entrar em um PC na nuvem. A azureADJoin opção permite que usuários somente em nuvem e híbridos sejam atribuídos e entrem, enquanto hybridAzureADJoin é restrita apenas a usuários híbridos. O valor padrão é hybridAzureADJoin. Os valores possíveis são: hybridAzureADJoin, azureADJoin, unknownFutureValue. A propriedade type foi preterida e parou de retornar dados em 31 de janeiro de 2024. No futuro, use a propriedade connectionType .
subnetPrivateIpDetail cloudPcOnPremisesConnectionSubnetIpDetail Contém informações detalhadas sobre os endereços IP privados associados à sub-rede. Retornado apenas em $select. Para obter um exemplo que mostra como recuperar propriedades específicas usando $select, consulte Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.

valores de cloudPcManagementService

Member Descrição
Windows365 A conexão de rede do Azure foi criada com êxito por meio do Windows 365.
devBox A conexão de rede do Azure foi criada com êxito por meio do Projeto Fidalgo.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.
rpaBox A conexão de rede do Azure foi criada com êxito por meio do projeto Power Automate.
microsoft365Opal Indica que a conexão de rede do Cloud PC Azure foi criada com êxito por meio do Project Opal.
microsoft365BizChat Indica que a conexão de rede do Cloud PC Azure foi criada com êxito por meio do Project Biz Chat.

valores de cloudPcOnPremisesConnectionType

Member Descrição
azureADJoin Ingressado apenas no Microsoft Entra ID. Usuários híbridos e somente em nuvem podem ser atribuídos e entrar no PC na nuvem.
hybridAzureADJoin Ingressado no Active Directory local e no Microsoft Entra ID. Somente usuários híbridos podem ser atribuídos e entrar no PC na nuvem.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.

valores de cloudPcOnPremisesConnectionStatus

Member Descrição
com falha As verificações de integridade notificam o cliente de que a conexão de rede do Azure não está configurada ou funcionando corretamente. Falha no provisionamento. O cliente precisa identificar o problema e resolvê-lo usando as diretrizes fornecidas pela conexão de rede do Azure para que o provisionamento seja bem-sucedido.
Informativo As verificações de integridade fornecem informações ao cliente sobre verificações de pré-requisitos atuais ou associadas em recursos de complemento do PC na nuvem, como o Logon Único. As verificações de integridade informativas não afetam o provisionamento do PC na Nuvem do cliente. As informações têm como objetivo otimizar a experiência do usuário.
Aprovado As verificações de integridade notificam o cliente de que a conexão de rede do Azure está funcionando conforme o esperado. O cliente pode provisionar seu PC na nuvem sem nenhum problema.
pendente Criado e aguardando verificações de integridade.
em execução As verificações de integridade estão sendo executadas.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.
warning As verificações de integridade notificam o cliente de que a conexão de rede do Azure não está configurada de acordo com as diretrizes de práticas recomendadas da Microsoft, como conectividade de ponto de extremidade. O cliente deve configurar os pontos de extremidade necessários para o PC na nuvem antes de provisionar um PC na nuvem. Ele não afeta o provisionamento do PC na nuvem do cliente, mas pode afetar a experiência do cliente.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o 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"
}
  • Última atualização em