Session Hosts - Get
Obtenha um host de sessão.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHosts/{sessionHostName}?api-version=2024-04-03
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
host
|
path | True |
string minLength: 3maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$ |
O nome do pool de host dentro do grupo de recursos especificado |
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
session
|
path | True |
string minLength: 3maxLength: 48 pattern: ^[A-Za-z0-9@.\-_ ]*$ |
O nome do host da sessão dentro do pool de host especificado |
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Host de sessão recuperado com êxito. |
|
Other Status Codes |
Resposta de erro de automação descrevendo por que a operação falhou. |
Exemplos
SessionHost_Get
Solicitação de exemplo
Resposta de exemplo
{
"name": "sessionHost1.microsoft.com",
"id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHosts/sessionHost1.microsoft.com",
"type": "Microsoft.DesktopVirtualization/hostPools/sessionHosts",
"systemData": {
"createdBy": "user1",
"createdByType": "User",
"createdAt": "2020-01-01T17:18:19.1234567Z",
"lastModifiedBy": "user2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
},
"properties": {
"objectId": "7877fb31-4bde-49fd-9df3-c046e0ec5325",
"lastHeartBeat": "2008-09-22T14:01:54.9571247Z",
"sessions": 1,
"agentVersion": "1.0.0.1391",
"allowNewSession": true,
"assignedUser": "user1@microsoft.com",
"status": "Available",
"statusTimestamp": "2008-09-22T14:01:54.9571247Z",
"osVersion": "10.0.17763",
"sxSStackVersion": "rdp-sxs190816002",
"updateState": "Succeeded",
"lastUpdateTime": "2008-09-22T14:01:54.9571247Z",
"updateErrorMessage": "",
"virtualMachineId": "29491b54-c033-4dec-b09a-18bf0ebafaef",
"friendlyName": "friendly",
"resourceId": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.Compute/virtualMachines/sessionHost1",
"sessionHostHealthCheckResults": [
{
"healthCheckName": "DomainJoinedCheck",
"healthCheckResult": "HealthCheckSucceeded",
"additionalFailureDetails": {
"message": "SessionHost healthy: is joined to domain ≤wvdarmtest1.net≥",
"errorCode": 0,
"lastHealthCheckDateTime": "2021-01-14T02:09:37.6236843Z"
}
}
]
}
}
Definições
Nome | Description |
---|---|
Cloud |
Objeto de erro de nuvem. |
Cloud |
Propriedades do objeto de erro de nuvem. |
created |
O tipo de identidade que criou o recurso. |
Health |
Representa o nome da operação de verificação de integridade executada. |
Health |
Representa o estado de integridade da verificação de integridade que executamos. |
Session |
Representa uma definição de SessionHost. |
Session |
Contém detalhes sobre a falha. |
Session |
O relatório para informações do host da sessão. |
Status |
Status de um SessionHost. |
system |
Metadados relativos à criação e última modificação do recurso. |
Update |
Atualizar o estado de um SessionHost. |
CloudError
Objeto de erro de nuvem.
Nome | Tipo | Description |
---|---|---|
error |
Propriedades do objeto de erro de nuvem. |
CloudErrorProperties
Propriedades do objeto de erro de nuvem.
Nome | Tipo | Description |
---|---|---|
code |
string |
Código de erro |
message |
string |
Mensagem de erro indicando por que a operação falhou. |
createdByType
O tipo de identidade que criou o recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
HealthCheckName
Representa o nome da operação de verificação de integridade executada.
Valor | Description |
---|---|
AppAttachHealthCheck |
Verifica se o AppAttachService está íntegro (não houve problemas durante o preparo do pacote). O AppAttachService é usado para habilitar o preparo/registro (e eventual desregistração/destaginação) de aplicativos MSIX que foram configurados pelo administrador do locatário. Isso verifica se o componente teve falhas durante o preparo do pacote. Falhas no preparo impedirão que alguns aplicativos MSIX funcionem corretamente para o usuário final. Se essa verificação falhar, ela não será fatal e o computador ainda poderá atender às conexões, o principal problema pode ser que alguns aplicativos não funcionem para os usuários finais. (Atualmente habilitado) |
DomainJoinedCheck |
Verifica se o SessionHost está ingressado em um domínio. Se essa verificação falhar, será classificada como fatal, pois nenhuma conexão poderá ser bem-sucedida se o SessionHost não estiver ingressado no domínio. (Atualmente habilitado) |
DomainReachable |
Verifica se o domínio ao qual SessionHost está ingressado ainda é acessível. Se essa verificação falhar, será classificada como fatal, pois nenhuma conexão poderá ser bem-sucedida se o domínio ingressado no SessionHost não for acessível no momento da conexão. (Atualmente desabilitado) |
DomainTrustCheck |
Verifica se o SessionHost não está enfrentando problemas de confiança de domínio que impedirão a autenticação no SessionHost no momento da conexão quando a sessão for criada. Se essa verificação falhar, será classificada como fatal, pois nenhuma conexão poderá ser bem-sucedida se não conseguirmos acessar o domínio para autenticação no SessionHost. (Atualmente habilitado) |
FSLogixHealthCheck |
Verifica se o serviço FSLogix está em execução para garantir que os perfis dos usuários sejam carregados na sessão. Se essa verificação falhar for classificada como fatal, mesmo que a conexão possa ser bem-sucedida, a experiência do usuário será ruim, pois o perfil de usuário não poderá ser carregado e o usuário obterá um perfil temporário na sessão. (Atualmente desabilitado) |
MetaDataServiceCheck |
Verifica se o serviço de metadados está acessível e retorna propriedades de computação. (Atualmente habilitado) |
MonitoringAgentCheck |
Verifica se o agente de Genebra necessário está em execução. Se essa verificação falhar, ela não será fatal e o computador ainda poderá atender às conexões, o principal problema pode ser que o agente de monitoramento esteja ausente ou executando (possivelmente) a versão mais antiga. (Atualmente habilitado) |
SupportedEncryptionCheck |
Verifica o valor da chave de registro do SecurityLayer. Se o valor for 0 (SecurityLayer.RDP), essa verificação falhará com o código de erro = NativeMethodErrorCode.E_FAIL e for fatal. Se o valor for 1 (SecurityLayer.Negotiate), essa verificação falhará com o código de erro = NativeMethodErrorCode.ERROR_SUCCESS e não for fatal. (Atualmente desabilitado) |
SxSStackListenerCheck |
Verifica se a pilha SxS está em execução para que as conexões possam ser bem-sucedidas. Se essa verificação falhar, será classificada como fatal, pois nenhuma conexão poderá ser bem-sucedida se a pilha SxS não estiver pronta. (Atualmente habilitado) |
UrlsAccessibleCheck |
Verifica se o serviço WVD necessário e as URLs de Genebra podem ser acessados no SessionHost. Essas URLs são: RdTokenUri, RdBrokerURI, RdDiagnosticsUri e URLs de blob de armazenamento para monitoramento de agente (geneva). Se essa verificação falhar, ela não será fatal e o computador ainda poderá atender às conexões, o principal problema pode ser que o agente de monitoramento não possa armazenar dados de caminho quente (logs, operações ...). (Atualmente desabilitado) |
WebRTCRedirectorCheck |
Verifica se o componente WebRTCRedirector está íntegro. O componente WebRTCRedirector é usado para otimizar o desempenho de vídeo e áudio no Microsoft Teams. Isso verifica se o componente ainda está em execução e se há uma versão mais alta disponível. Se essa verificação falhar, ela não será fatal e o computador ainda poderá atender às conexões, o principal problema pode ser que o componente WebRTCRedirector precise ser reiniciado ou atualizado. (Atualmente desabilitado) |
HealthCheckResult
Representa o estado de integridade da verificação de integridade que executamos.
Valor | Description |
---|---|
HealthCheckFailed |
Falha na verificação de integridade. |
HealthCheckSucceeded |
Verificação de integridade aprovada. |
SessionHostShutdown |
Recebemos uma notificação de desligamento. |
Unknown |
O resultado da verificação de integridade não é conhecido no momento. |
SessionHost
Representa uma definição de SessionHost.
Nome | Tipo | Description |
---|---|---|
id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
O nome do recurso |
properties.agentVersion |
string |
Versão do agente no SessionHost. |
properties.allowNewSession |
boolean |
Permitir uma nova sessão. |
properties.assignedUser |
string |
Usuário atribuído ao SessionHost. |
properties.friendlyName |
string |
Nome amigável de SessionHost |
properties.lastHeartBeat |
string (date-time) |
Última batida cardíaca de SessionHost. |
properties.lastUpdateTime |
string (date-time) |
O carimbo de data/hora da última atualização. |
properties.objectId |
string |
ObjectId de SessionHost. (uso interno) |
properties.osVersion |
string |
A versão do sistema operacional no host da sessão. |
properties.resourceId |
string |
ID de recurso da máquina virtual subjacente do SessionHost. |
properties.sessionHostHealthCheckResults |
Lista de SessionHostHealthCheckReports |
|
properties.sessions |
integer (int32) |
Número de sessões no SessionHost. |
properties.status |
Status de um SessionHost. |
|
properties.statusTimestamp |
string (date-time) |
O carimbo de data/hora do status. |
properties.sxSStackVersion |
string |
A versão da pilha lado a lado no host da sessão. |
properties.updateErrorMessage |
string |
A mensagem de erro. |
properties.updateState |
Atualizar o estado de um SessionHost. |
|
properties.virtualMachineId |
string |
ID de máquina virtual da máquina virtual subjacente do SessionHost. |
systemData |
Metadados relativos à criação e última modificação do recurso. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
SessionHostHealthCheckFailureDetails
Contém detalhes sobre a falha.
Nome | Tipo | Description |
---|---|---|
errorCode |
integer (int32) |
Código de erro correspondente à falha. |
lastHealthCheckDateTime |
string (date-time) |
O carimbo de data/hora da última atualização. |
message |
string |
Mensagem de falha: dicas sobre o que está errado e como se recuperar. |
SessionHostHealthCheckReport
O relatório para informações do host da sessão.
Nome | Tipo | Description |
---|---|---|
additionalFailureDetails |
Informações detalhadas adicionais sobre a falha. |
|
healthCheckName |
Representa o nome da operação de verificação de integridade executada. |
|
healthCheckResult |
Representa o estado de integridade da verificação de integridade que executamos. |
Status
Status de um SessionHost.
Valor | Description |
---|---|
Available |
O Host de Sessão passou por todas as verificações de integridade e está disponível para lidar com conexões. |
Disconnected |
O Host da Sessão não está disponível porque está desconectado no momento. |
DomainTrustRelationshipLost |
Relação de confiança de domínio do SessionHost perdida |
FSLogixNotHealthy |
O FSLogix está em um estado não íntegro no host da sessão. |
NeedsAssistance |
Novo status para informar aos administradores que a integridade em seu ponto de extremidade precisa ser corrigida. As conexões podem não falhar, pois esses problemas não são fatais. |
NoHeartbeat |
O Host da Sessão não está batendo no coração. |
NotJoinedToDomain |
SessionHost não está ingressado no domínio. |
Shutdown |
O Host da Sessão está desligado – o host de sessão relatado pelo Agente de Área de Trabalho Remota deve ser interrompido ou desalocado. |
SxSStackListenerNotReady |
A pilha SxS instalada no SessionHost não está pronta para receber conexões. |
Unavailable |
O Host de Sessão está desativado ou falhou em verificações de integridade críticas, o que está fazendo com que o serviço não possa rotear conexões para este host de sessão. Observe que isso substitui o status 'NoHeartBeat' anterior. |
UpgradeFailed |
O Host de Sessão não está disponível porque a atualização crítica do componente (agente, pilha lado a lado, etc.) falhou. |
Upgrading |
O Host de Sessão não está disponível porque atualmente uma atualização da pilha RDAgent/lado a lado está em andamento. Observação: esse estado será removido assim que a atualização for concluída e o host puder aceitar conexões. |
systemData
Metadados relativos à criação e última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UpdateState
Atualizar o estado de um SessionHost.
Valor | Description |
---|---|
Failed | |
Initial | |
Pending | |
Started | |
Succeeded |