Tipo de recurso cloudPcOnPremisesConnection

Artigo
06/21/2022
4 minutos para o fim da leitura

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 de 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 na nuvem.

Importante

A conexão de rede local foi renomeada para conexão de rede do Azure. Os objetos cloudPcOnPremisesConnection aqui são equivalentes à conexão de rede do Azure para o produto pc na nuvem.

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 cloudPcOnPremisesConnection	Nenhum	Execute verificações de integridade no cloudPcOnPremisesConnection.
updateAdDomainPassword	Nenhum	Atualize a senha de domínio do Active Directory para um cloudPcOnPremisesConnection bem-sucedido. Essa API tem suporte quando o tipo do objeto cloudPcOnPremisesConnection é `hybridAzureADJoin`.

Propriedades

Propriedade	Tipo	Descrição
adDomainName	String	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 a adDomainUsername.
adDomainUsername	String	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 obrigatório: `admin@contoso.com`. Opcional.
alternateResourceUrl	String	A URL da interface do recurso do serviço de parceiro que se vincula a essa conexão de rede do Azure. Retornado apenas em `$select`.
displayName	Cadeia de caracteres	O nome de exibição da conexão de rede do Azure.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	O status da verificação 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 todas as verificações executadas pelo serviço. Os valores possíveis são: `pending`, `running`, `passed`, `failed`, `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.
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 o 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` e `devBox,` `unknownFutureValue`. Somente leitura.
organizationalUnit	Cadeia de caracteres	A UO (unidade organizacional) na qual a conta de computador é criada. Se for deixado nulo, a UO configurada como padrão (um contêiner de objeto de computador conhecido) em seu domínio do Active Directory (UO) será usada. Opcional.
resourceGroupId	Cadeia de caracteres	A ID do grupo de recursos de destino. Formato obrigatório: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.
subnetId	Cadeia de caracteres	A ID da sub-rede de destino. Formato obrigató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 seu locatário.
subscriptionName	Cadeia de caracteres	O nome da assinatura de destino do Azure. Somente leitura.
type	cloudPcOnPremisesConnectionType	Especifica como o PC na nuvem provisionado será ingressado no Azure Active Directory. O valor padrão é `hybridAzureADJoin`. Os valores possíveis são: `azureADJoin`, `hybridAzureADJoin`, `unknownFutureValue`.
virtualNetworkId	Cadeia de caracteres	A ID da rede virtual de destino. Formato obrigatório: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}`.

Valores de cloudPcManagementService

Membro	Valor	Descrição
windows365	1	A conexão de rede do Azure foi criada com êxito por meio do Windows365.
devBox	2	A conexão de rede do Azure foi criada com êxito Project Fidalgo.
unknownFutureValue	4	Valor de sentinel de enumeração evolvável. Não usar.

Valores cloudPcOnPremisesConnectionType

Member	Descrição
hybridAzureADJoin	Ingressado Active Directory local e Azure AD. Somente usuários híbridos podem ser atribuídos e entrar no PC na nuvem.
azureADJoin	Ingressado apenas Azure AD. Usuários híbridos e somente na nuvem podem ser atribuídos e entrar no PC na nuvem.
unknownFutureValue	Valor de sentinel de enumeração evolvável. Não usar.

Valores cloudPcOnPremisesConnectionStatus

Member	Descrição
Pendente	Criado e aguardando verificações de integridade.
Executando	As verificações de integridade estão em execução.
Passado	Verificações de integridade aprovadas.
Falhou	Falha nas verificações de integridade.
warning	Verificações de integridade passadas com aviso.
unknownFutureValue	Valor de sentinel de enumeração evolvável. Não usar.

Relações

Nenhum

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetails": {
    "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails",
    "endDateTime": "String (timestamp)",
    "healthChecks": [
      { 
        "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
        "additionalDetails": "String",
        "displayName": "String",
        "endDateTime": "String (timestamp)",
        "errorType": "String",
        "recommendedAction": "String",
        "startDateTime": "String (timestamp)",
        "status": "String"
      }
    ],
    "startDateTime": "String (timestamp)"
  },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String"
}