tipo de recurso cloudPcOnPremisesConnection

Artigo
03/27/2024

Namespace: microsoft.graph

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.

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. O comprimento máximo é 255. Opcional.
adDomainPassword	Cadeia de caracteres	A senha associada ao nome de usuário de uma conta do Active Directory (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ão 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 como o pc de nuvem provisionado se junta ao Microsoft Entra. Ele inclui tipos diferentes, um é Microsoft Entra ID junção, o que significa que não há Active Directory local (AD) no locatário atual, e o dispositivo Cloud PC é acompanhado por Microsoft Entra. Outro é hybridAzureADJoin, o que significa que também há um Active Directory local (AD) no locatário atual e o dispositivo Cloud PC se junta a Active Directory local (AD) e Microsoft Entra. O tipo também determina quais tipos de usuários podem ser atribuídos e podem entrar em um PC na Nuvem. O tipo azureADJoin indica que usuários híbridos e somente na nuvem podem ser atribuídos e conectados ao PC na Nuvem. hybridAzureADJoin indica que apenas usuários híbridos podem ser atribuídos e conectados ao PC de Nuvem. O valor padrão é `hybridAzureADJoin`.
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 local. Por exemplo, se o status for `passed`, a conexão local passou todas as verificações executadas pelo serviço. Valores possíveis: `pending`, , `running`, `passed`, `failed`, `warning`. `informational` O padrão é `pending`. Somente leitura.
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Indica os resultados das verificações de integridade realizadas na conexão local. Somente leitura. 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 healthCheckStatusDetail. 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 healthCheckStatusDetail. Somente leitura.
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) no DOMÍNIO do Active Directory (OU) do locatário será usado. Opcional.
resourceGroupId	Cadeia de caracteres	O identificador exclusivo do grupo de recursos de destino usado associado à conectividade de rede local para PCs de nuvem. Formato obrigatório: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}"
subnetId	Cadeia de caracteres	O identificador exclusivo da sub-rede de destino usada associada à conectividade de rede local para PCs de nuvem. Formato obrigatório: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}"
subscriptionId	Cadeia de caracteres	O identificador exclusivo da assinatura do Azure associado ao locatário.
subscriptionName	Cadeia de caracteres	O nome da assinatura do Azure é usado para criar uma conexão de rede do Azure. Somente leitura.
virtualNetworkId	Cadeia de caracteres	O identificador exclusivo da rede virtual de destino usada associada à conectividade de rede local para PCs de nuvem. Formato obrigatório: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}"
virtualNetworkLocation	Cadeia de caracteres	Indica o local do recurso da rede virtual de destino. Por exemplo, o local pode ser eastus2, westeurope etc. Somente leitura (valor computado).

valores cloudPcOnPremisesConnectionType

Member	Descrição
azureADJoin	Indica que os dispositivos cloud pc são unidos apenas para Microsoft Entra ID.
hybridAzureADJoin	Indica que os dispositivos cloud pc estão unidos a Active Directory local e registrados com Microsoft Entra ID.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

valores cloudPcOnPremisesConnectionStatus

Member	Descrição
Falhou	Indica que as verificações de integridade de conexão de rede do Cloud PC Azure já foram concluídas, com falhas. O ambiente do cliente não está configurado corretamente, o que leva ao provisionamento de falha do Cloud PC. O cliente precisa identificar o problema e resolve-lo usando as diretrizes fornecidas pela conexão local para provisionamento com êxito.
Informativo	Indica que as verificações de integridade de conexão de rede do Cloud PC Azure já foram concluídas, com informações de marcar de integridade. As verificações de integridade fornecem informações aos clientes sobre verificações de pré-requisito atuais ou associadas status em recursos de complemento do Cloud PC, como Logon Único. Isso não afeta o provisionamento dos PCs de nuvem de nossos clientes, mas pretende otimizar a experiência do usuário.
Passado	Indica que as verificações de integridade da conexão de rede do Cloud PC Azure foram concluídas e passadas. O cliente pode provisionar seu COMPUTADOR na Nuvem sem nenhum problema.
Pendente	Padrão. Indica que a marcar de integridade da conexão de rede do Azure do Cloud PC está iniciada e aguardando a conclusão.
Executando	Indica que as verificações de integridade de conexão de rede do Cloud PC Azure ainda estão em execução.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
warning	Indica que as verificações de integridade de conexão de rede do Cloud PC Azure já foram concluídas, com falhas. O ambiente do cliente não está configurado corretamente, o que leva ao provisionamento de falha do Cloud PC. O cliente precisa identificar o problema e resolve-lo usando as diretrizes fornecidas pela conexão local para provisionamento com êxito.

Relações

Nenhum

Representação JSON

A seguir está um exemplo do 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"
}

Share via