cloudPcOnPremises Tipo de recurso de ligação
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 utilizadas para estabelecer conectividade de rede do Azure para PCs na Cloud.
Importante
O nome da ligação de rede no local foi mudado como ligação de rede do Azure. os objetos cloudPcOnPremisesConnection aqui são equivalentes à ligação de rede do Azure para o produto cloud PC.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | cloudPcOnPremisesConnection collection (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 | Atualize as propriedades de um objeto cloudPcOnPremisesConnection . |
| Delete | Nenhum | Eliminar um objeto cloudPcOnPremisesConnection . Não pode eliminar uma ligação que esteja a ser utilizada. |
| Executar verificações de estado de funcionamento | Nenhum | Execute verificações de estado de funcionamento na cloudPcOnPremisesConnection. |
| Atualizar palavra-passe de domínio do Active Directory | Nenhum | Atualizar a palavra-passe de domínio do Active Directory para uma cloudPcOnPremisesConnection bem-sucedida. Esta API é suportada quando o tipo de objeto cloudPcOnPremisesConnection é hybridAzureADJoin. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| adDomainName | Cadeia de caracteres | O nome de domínio completamente qualificado (FQDN) do domínio do Active Directory que pretende associar. Opcional. |
| adDomainPassword | Cadeia de caracteres | A palavra-passe associada a adDomainUsername. |
| adDomainUsername | Cadeia de caracteres | O nome de utilizador de uma conta do Active Directory (conta de utilizador ou de serviço) que tem permissões para criar objetos de computador no Active Directory. Formato obrigatório: admin@contoso.com. Opcional. |
| alternateResourceUrl | Cadeia de caracteres | O URL de interface do recurso do serviço de parceiros que liga a esta ligação de rede do Azure. Retornado apenas em $select. |
| connectionType | cloudPcOnPremisesConnectionType | Especifica o método através do qual um PC cloud aprovisionado está associado a Microsoft Entra. A azureADJoin opção indica a ausência de um Active Directory local (AD) no inquilino atual que resulta na associação do dispositivo CLOUD PC apenas a Microsoft Entra. A hybridAzureADJoin opção indica a presença de um AD no local no inquilino atual e que o CLOUD PC associa o AD no local e Microsoft Entra. A opção selecionada também determina os tipos de utilizadores que podem ser atribuídos e podem iniciar sessão num PC na Cloud. A azureADJoin opção permite que os utilizadores apenas na cloud e híbridos sejam atribuídos e iniciem sessão, enquanto hybridAzureADJoin está restrita apenas a utilizadores híbridos. O valor padrão é hybridAzureADJoin. Os valores possíveis são: hybridAzureADJoin, azureADJoin, unknownFutureValue. |
| displayName | Cadeia de caracteres | O nome a apresentar da ligação de rede do Azure. |
| healthCheckStatus | cloudPcOnPremisesConnectionStatus | A status do estado de funcionamento mais recente marcar efetuada na ligação de rede do Azure. Por exemplo, se o status for passed, a ligaçã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 estado de funcionamento da ligação e os resultados correspondentes. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse , veja Exemplo 2: Obter as propriedades selecionadas de uma ligação de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura. |
| healthCheckStatusDetails (preterido) | cloudPcOnPremisesConnectionStatusDetails | Indica as verificações de estado de funcionamento da ligação e os respetivos resultados. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse , veja Exemplo 2: Obter as propriedades selecionadas de uma ligação de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura. A propriedade healthCheckStatusDetails foi preterida e deixou de devolver dados a 31 de janeiro de 2024. No futuro, utilize a propriedade healthCheckStatusDetail . |
| healthCheckStatusDetail | cloudPcOnPremisesConnectionStatusDetail | Indica os resultados das verificações de estado de funcionamento realizadas na ligação no local. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse , veja Exemplo 2: Obter as propriedades selecionadas de uma ligação de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura. |
| id | Cadeia de caracteres | Identificador exclusivo para a ligação de rede do Azure. Somente leitura. |
| inUse | Booliano | Quando true, a ligação de rede do Azure está a ser utilizada. Quando false, a ligação não está a ser utilizada. Não pode eliminar uma ligação que esteja a ser utilizada. Retornado apenas em $select. Para obter um exemplo que mostra como obter a propriedade inUse , veja Exemplo 2: Obter as propriedades selecionadas de uma ligação de rede do Azure, incluindo healthCheckStatusDetails. Somente leitura. |
| inUseByCloudPc | Booliano | Indica se um PC na Cloud está a utilizar esta ligação de rede no local.
true se, pelo menos, um PC cloud estiver a utilizá-lo. Caso contrário, false. Somente leitura. O padrão é false. |
| healthCheckPaused | Booliano |
false se as verificações de estado de funcionamento regulares na configuração de rede/domínio estiverem atualmente ativas.
true se as verificações estiverem em pausa. Se efetuar uma operação de criação ou atualização num recurso onPremisesNetworkConnection , este valor será definido false como durante 4 semanas. Se repetir uma marcar de estado de funcionamento na configuração de rede/domínio, este valor está definido como false durante duas semanas. Se o recurso onPremisesNetworkConnection estiver anexado num provisioningPolicy ou utilizado por um PC na Cloud nas últimas 4 semanas, healthCheckPaused está definido como false. Somente leitura. O padrão é false. |
| managedBy | cloudPcManagementService | Especifica os serviços que gerem a ligação de rede do Azure. Os valores possíveis são: windows365, devBox, unknownFutureValue, rpaBox. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter o seguinte valor nesta enumeração evoluível: rpaBox. Somente leitura. |
| organizationalUnit | Cadeia de caracteres | A unidade organizacional (UO) na qual a conta de computador é criada. Se for deixada nula, é utilizada a UO configurada como predefinição (um contentor de objetos de computador conhecido) no seu domínio do Active Directory (UO). Opcional. |
| organizationalUnit | Cadeia de caracteres | A unidade organizacional (UO) na qual a conta de computador é criada. Se for deixada nula, é utilizada a UO configurada como predefinição (um contentor de objetos de computador conhecido) no seu domínio do Active Directory (UO). Opcional. |
| virtualNetworkId | Cadeia de caracteres | O ID da rede virtual de destino. Formato obrigatório: /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 calculado só de leitura. |
| resourceGroupId | Cadeia de caracteres | O ID do grupo de recursos de destino. Formato obrigatório: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}. |
| subnetId | Cadeia de caracteres | O 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 | O ID da subscrição do Azure de destino associada ao seu inquilino. |
| subscriptionName | Cadeia de caracteres | O nome da subscrição do Azure de destino. Somente leitura. |
| tipo (preterido) | cloudPcOnPremisesConnectionType | Especifica o método através do qual um PC cloud aprovisionado está associado a Microsoft Entra. A azureADJoin opção indica a ausência de um Active Directory local (AD) no inquilino atual que resulta na associação do dispositivo CLOUD PC apenas a Microsoft Entra. A hybridAzureADJoin opção indica a presença de um AD no local no inquilino atual e que o CLOUD PC associa o AD no local e Microsoft Entra. A opção selecionada também determina os tipos de utilizadores que podem ser atribuídos e podem iniciar sessão num PC na Cloud. A azureADJoin opção permite que os utilizadores apenas na cloud e híbridos sejam atribuídos e iniciem sessão, enquanto hybridAzureADJoin está restrita apenas a utilizadores híbridos. O valor padrão é hybridAzureADJoin. Os valores possíveis são: hybridAzureADJoin, azureADJoin, unknownFutureValue. A propriedade type foi preterida e deixou de devolver dados a 31 de janeiro de 2024. No futuro, utilize a propriedade connectionType . |
valores cloudPcManagementService
| Member | Descrição |
|---|---|
| devBox | A ligação de rede do Azure foi criada com êxito através do Project Fidalgo. |
| rpaBox | A ligação de rede do Azure foi criada com êxito através do projeto do Power Automate. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
| windows365 | A ligação de rede do Azure foi criada com êxito através do Windows 365. |
cloudPcOnPremisesConnectionType values (valores cloudPcOnPremisesConnectionType)
| Member | Descrição |
|---|---|
| azureADJoin | Associado apenas a Microsoft Entra ID. Os utilizadores apenas na cloud e híbridos podem ser atribuídos e iniciar sessão no CLOUD PC. |
| hybridAzureADJoin | Associado ao Active Directory local e ao Microsoft Entra ID. Apenas os utilizadores híbridos podem ser atribuídos e iniciar sessão no CLOUD PC. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
cloudPcOnPremisesConnectionStatus values (valores cloudPcOnPremisesConnectionStatus)
| Member | Descrição |
|---|---|
| falha | As verificações de estado de funcionamento notificam o cliente de que a ligação de rede do Azure não está corretamente configurada ou a funcionar. O aprovisionamento falha. O cliente tem de identificar o problema e resolve-lo com a documentação de orientação fornecida pela ligação de rede do Azure para que o aprovisionamento seja bem-sucedido. |
| informativo | As verificações de estado de funcionamento fornecem informações ao cliente sobre as verificações de pré-requisitos atuais ou associadas nas funcionalidades de suplementos do Cloud PC, como o Início de Sessão Único. As verificações de estado de funcionamento informativo não afetam o aprovisionamento do CLOUD PC do cliente. As informações destinam-se a otimizar a experiência do utilizador. |
| passado | As verificações de estado de funcionamento notificam o cliente de que a ligação de rede do Azure está a funcionar conforme pretendido. O cliente pode aprovisionar o PC na Cloud sem qualquer problema. |
| pendente | Criado e a aguardar por verificações de estado de funcionamento. |
| em execução | As verificações de estado de funcionamento estão em execução. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
| warning | As verificações de estado de funcionamento notificam o cliente de que a ligação de rede do Azure não está configurada de acordo com as orientações de melhores práticas da Microsoft, como a conectividade do ponto final. O cliente deve configurar os pontos finais necessários para o Cloud PC antes de aprovisionar um PC na Cloud. Não afeta o aprovisionamento do CLOUD PC do cliente, mas pode afetar a experiência do cliente. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte 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",
"inUseByCloudPc": "Boolean",
"healthCheckPaused": "Boolean",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}