Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 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. 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 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 como o PC na nuvem provisionado ingressa no Microsoft Entra. Inclui tipos diferentes, um deles é o ingresso no Microsoft Entra ID, o que significa que não há nenhum Active Directory local (AD) no locatário atual e o dispositivo Cloud PC é ingressado pelo Microsoft Entra. Outro é hybridAzureADJoin, o que significa que também há um Active Directory local (AD) no locatário atual e o dispositivo de PC na nuvem ingressa no Active Directory local (AD) e no 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 em 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 na nuvem. O valor padrão é hybridAzureADJoin. |
| 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 local. Por exemplo, se o status for passed, a conexão local passou em todas as verificações executadas pelo serviço. Valores possíveis: pending, running, passed, failedwarning, informational, . O padrão é pending. Somente leitura. |
| healthCheckStatusDetail | cloudPcOnPremisesConnectionStatusDetail | Indica os resultados das verificações de integridade executadas na conexão local. Somente leitura. Requer $select recuperação. 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 healthCheckStatusDetail. 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 healthCheckStatusDetail. 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. |
| organizationalUnit | Cadeia de caracteres | A unidade organizacional (OU) na qual a conta de computador é criada. Se for deixada nula, a OU configurada como padrão (um contêiner de objeto de computador conhecido) no domínio do Active Directory (OU) do locatário será usada. Opcional. |
| resourceGroupId | Cadeia de caracteres | O identificador exclusivo do grupo de recursos de destino usado associado à conectividade de rede local para PCs na nuvem. Formato necessário: "/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 | O identificador exclusivo da sub-rede de destino usada associada à conectividade de rede local para PCs na nuvem. Formato necessário: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}" |
| subscriptionId | Cadeia de caracteres | O identificador exclusivo da assinatura do Azure associada ao locatário. |
| Nome da assinatura | 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 na nuvem. Formato necessário: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}" |
| virtualNetworkLocation | Cadeia de caracteres | Indica a localização do recurso da rede virtual de destino. Por exemplo, o local pode ser eastus2, westeurope etc. Somente leitura (valor calculado). |
valores de cloudPcOnPremisesConnectionType
| Member | Descrição |
|---|---|
| azureADJoin | Indica que os dispositivos PC na nuvem estão ingressados apenas no Microsoft Entra ID. |
| hybridAzureADJoin | Indica que os dispositivos do PC na nuvem ingressaram no Active Directory local e foram registrados com o Microsoft Entra ID. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
valores de cloudPcOnPremisesConnectionStatus
| Member | Descrição |
|---|---|
| com falha | Indica que as verificações de integridade da conexão de rede do Azure na nuvem foram concluídas, com falhas. O ambiente do cliente não está configurado corretamente, o que leva a uma falha no provisionamento do PC na Nuvem. O cliente precisa identificar o problema e resolvê-lo usando as diretrizes fornecidas pela conexão local para provisionamento bem-sucedido. |
| Informativo | Indica que as verificações de integridade de conexão de rede do Azure na nuvem foram concluídas, com informações de marca de integridade. As verificações de integridade fornecem informações aos clientes sobre o status de verificações de pré-requisitos atuais ou associadas nos recursos de complemento do PC na nuvem, como o Logon Único. Ele não afeta o provisionamento dos PCs na nuvem de nossos clientes, mas pretende otimizar a experiência do usuário. |
| Aprovado | Indica que as verificações de integridade da conexão de rede do Azure na nuvem foram concluídas e aprovadas. O cliente pode provisionar seu PC na nuvem sem nenhum problema. |
| pendente | Padrão. Indica que a marca de integridade da conexão de rede do Azure na nuvem foi iniciada e aguarda a conclusão. |
| em execução | Indica que as verificações de integridade da conexão de rede do Azure na nuvem ainda estão em execução. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
| warning | Indica que as verificações de integridade da conexão de rede do Azure na nuvem foram concluídas, com falhas. O ambiente do cliente não está configurado corretamente, o que leva a uma falha no provisionamento do PC na nuvem. O cliente precisa identificar o problema e resolvê-lo usando as diretrizes fornecidas pela conexão local para provisionamento bem-sucedido. |
Relações
Nenhum
Representação JSON
O exemplo 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" },
"id": "String (identifier)",
"inUse": "Boolean",
"inUseByCloudPc": "Boolean",
"organizationalUnit": "String",
"resourceGroupId": "String",
"scopeIds": ["String"],
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"virtualNetworkId": "String"
}