tipo de recurso cloudPcOnPremisesConnection

Artigo
03/18/2024

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 PCs de 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
Listar onPremisesConnections	coleção cloudPcOnPremisesConnection	Listar propriedades e relações dos objetos cloudPcOnPremisesConnection .
Obter cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Leia as propriedades e as relações do objeto cloudPcOnPremisesConnection .
Criar cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Crie um novo objeto cloudPcOnPremisesConnection .
Atualizar cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Atualize as propriedades de um objeto cloudPcOnPremisesConnection .
Excluir cloudPcOnPremisesConnection	Nenhum	Exclua um objeto cloudPcOnPremisesConnection . Você não pode excluir uma conexão que está em uso.
RunHealthChecks de um cloudPcOnPremisesConnection	Nenhum	Execute verificações de integridade na nuvemPcOnPremisesConnection.
updateAdDomainPassword	Nenhum	Atualize a senha de domínio do Active Directory para uma cloudPcOnPremisesConnection bem-sucedida. Essa API tem suporte quando o tipo do objeto cloudPcOnPremisesConnection é `hybridAzureADJoin`.

Propriedades

Propriedade	Tipo	Descrição
adDomainName	Cadeia de caracteres	O FQDN (nome de domínio totalmente qualificado) do domínio do Active Directory que 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 necessário: `admin@contoso.com`. Opcional.
alternateResourceUrl	Cadeia de caracteres	A URL de interface do recurso do serviço de parceiro que é vinculada a essa conexão de rede do Azure. Retornado apenas em `$select`.
Connectiontype	cloudPcOnPremisesConnectionType	Especifica o método pelo qual um PC de Nuvem provisionado é ingressado para Microsoft Entra. A `azureADJoin` opção indica a ausência de um Active Directory local (AD) no locatário atual que resulta na junção do dispositivo cloud PC apenas ao Microsoft Entra. A `hybridAzureADJoin` opção indica a presença de um AD local no locatário atual e que o PC de Nuvem une o AD local e o 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 híbridos e somente nuvem sejam atribuídos e entrem, enquanto `hybridAzureADJoin` é restrito 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.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	O status do marcar de integridade mais recente feito na conexão de rede do Azure. Por exemplo, se o status for `passed`, a conexão de rede do Azure passou todas as verificações executadas pelo serviço. Os valores possíveis são: `pending`, `running`, `passed`, `failed`, `warning`, `informational` e `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 Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
healthCheckStatusDetails (preterido)	cloudPcOnPremisesConnectionStatusDetails	Indica as verificações de integridade da conexão e seus respectivos resultados. Retornado apenas em `$select`. Para obter um exemplo que mostra como obter a propriedade inUse , consulte 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. Vá em frente, use a propriedade healthCheckStatusDetail .
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Indica os resultados das verificações de integridade realizadas na conexão local. Retornado apenas em `$select`. Para obter um exemplo que mostra como obter a propriedade inUse , consulte Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
id	Cadeia de caracteres	Identificador exclusivo para a conexão de rede do Azure. Somente leitura.
inUse	Booliano	Quando `true`, a conexão de rede do Azure está em uso. Quando `false`, a conexão não está em uso. Você não pode excluir uma conexão que está em uso. Retornado apenas em `$select`. Para obter um exemplo que mostra como obter a propriedade inUse , consulte Exemplo 2: Obter as propriedades selecionadas de uma conexão de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura.
Managedby	cloudPcManagementService	Especifica quais serviços gerenciam a conexão de rede do Azure. Os valores possíveis são: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`. Você deve usar o `Prefer: include-unknown-enum-members` cabeçalho de solicitação para obter os seguintes valores neste enumerável em evolução: `rpaBox`. Somente leitura.
organizationalUnit	Cadeia de caracteres	A OU (unidade organizacional) na qual a conta do computador é criada. Se deixado nulo, o OU configurado como o padrão (um contêiner de objeto de computador conhecido) em seu DOMÍNIO do Active Directory (OU) será usado. Opcional.
organizationalUnit	Cadeia de caracteres	A OU (unidade organizacional) na qual a conta do computador é criada. Se deixado nulo, a OU configurada como o padrão (um contêiner de objeto de computador bem conhecido) em seu domínio do Active Directory (OU) será usado. Opcional.
virtualNetworkId	Cadeia de caracteres	A ID da rede virtual de destino. Formato necessário: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}`.
virtualNetworkLocation	Cadeia de caracteres	Indica o local do recurso da rede de destino virtual. Valor computado somente leitura.
resourceGroupId	Cadeia de caracteres	A ID do grupo de recursos de destino. Formato necessário: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.
subnetId	Cadeia de caracteres	A ID da sub-rede de destino. Formato necessário: `/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 locatário.
subscriptionName	Cadeia de caracteres	O nome da assinatura do Azure de destino. Somente leitura.
tipo (preterido)	cloudPcOnPremisesConnectionType	Especifica o método pelo qual um PC de Nuvem provisionado é ingressado para Microsoft Entra. A `azureADJoin` opção indica a ausência de um Active Directory local (AD) no locatário atual que resulta na junção do dispositivo cloud PC apenas ao Microsoft Entra. A `hybridAzureADJoin` opção indica a presença de um AD local no locatário atual e que o PC de Nuvem une o AD local e o 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 híbridos e somente nuvem sejam atribuídos e entrem, enquanto `hybridAzureADJoin` é restrito 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. Vá em frente, use a propriedade connectionType .

valores cloudPcManagementService

Member	Descrição
devBox	A conexão de rede do Azure foi criada com êxito por meio do Project Fidalgo.
rpaBox	A conexão de rede do Azure foi criada com êxito por meio do projeto do Power Automate.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
windows365	A conexão de rede do Azure foi criada com êxito por meio de Windows 365.

valores cloudPcOnPremisesConnectionType

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

valores cloudPcOnPremisesConnectionStatus

Member	Descrição
Falhou	Verificações de integridade notificam o cliente de que a conexão de rede do Azure não está configurada ou funcionando corretamente. O provisionamento falha. O cliente precisa identificar o problema e resolve-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 Cloud PC, como Logon Único. Isso não afetará o provisionamento do pc cloud do cliente, mas as informações visam otimizar a experiência do usuário.
Passado	Verificações de integridade notificam o cliente de que a conexão de rede do Azure está operando conforme o planejado. O cliente pode provisionar seu COMPUTADOR na Nuvem sem nenhum problema.
Pendente	Criado e aguardando verificações de integridade.
Executando	As verificações de integridade estão em execução.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
warning	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 melhores práticas da Microsoft, como conectividade de ponto de extremidade. O cliente deve configurar os pontos de extremidade necessários para PC na Nuvem antes de provisionar um PC na Nuvem. Isso não afeta o provisionamento do pc cloud 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",
  "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"
}