Session Hosts - Get

Ottenere un host di sessione.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/sessionHosts/{sessionHostName}?api-version=2021-01-14-preview

Parametri dell'URI

Name In Required Type Description
hostPoolName
path True
  • string

Nome del pool di host all'interno del gruppo di risorse specificato

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

sessionHostName
path True
  • string

Nome dell'host sessione all'interno del pool di host specificato

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Risposte

Name Type Description
200 OK

Recupero dell'host di sessione completato.

Other Status Codes

Risposta di errore di automazione che descrive il motivo per cui l'operazione non è riuscita.

Esempio

SessionHost_Get

Sample Request

GET https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/sessionHosts/sessionHost1.microsoft.com?api-version=2021-01-14-preview

Sample Response

{
  "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",
  "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",
    "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"
        }
      }
    ]
  }
}

Definizioni

CloudError
CloudErrorProperties
HealthCheckName

Rappresenta il nome dell'operazione di controllo dell'integrità eseguita.

HealthCheckResult

Rappresenta lo stato di integrità del controllo integrità eseguito.

SessionHost

Rappresenta una definizione SessionHost.

SessionHostHealthCheckFailureDetails

Contiene informazioni dettagliate sull'errore.

SessionHostHealthCheckReport

Report per le informazioni sull'host della sessione.

Status

Stato per un oggetto SessionHost.

UpdateState

Aggiornare lo stato di un oggetto SessionHost.

CloudError

Name Type Description
error

CloudErrorProperties

Name Type Description
code
  • string

Codice di errore

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

HealthCheckName

Rappresenta il nome dell'operazione di controllo dell'integrità eseguita.

Name Type Description
AppAttachHealthCheck
  • string

Verifica che AppAttachService sia integro (non si sono verificati problemi durante la gestione temporanea del pacchetto). AppAttachService viene usato per abilitare la gestione temporanea/registrazione (e l'eventuale deregistrazione/destaging) delle app MSIX che sono state impostate dall'amministratore del tenant. In questo modo viene verificato se il componente ha avuto errori durante la gestione temporanea del pacchetto. Gli errori nella gestione temporanea impediranno il corretto funzionamento di alcune app MSIX per l'utente finale. Se questo controllo ha esito negativo, non è irreversibile e il computer può comunque eseguire le connessioni al servizio. Il problema principale potrebbe essere che alcune app non funzioneranno per gli utenti finali.

DomainJoinedCheck
  • string

Verifica che SessionHost sia aggiunto a un dominio. Se questo controllo ha esito negativo, viene classificato come irreversibile perché nessuna connessione può avere esito positivo se SessionHost non è aggiunto al dominio.

DomainReachable
  • string

Verifica che il dominio a cui è aggiunto SessionHost sia ancora raggiungibile. Se questo controllo ha esito negativo viene classificato come irreversibile perché nessuna connessione può avere esito positivo se il dominio a cui è aggiunto SessionHost non è raggiungibile al momento della connessione.

DomainTrustCheck
  • string

Verifica che SessionHost non stia riscontrando problemi di attendibilità del dominio che impediranno l'autenticazione in SessionHost in fase di connessione quando viene creata la sessione. Se questo controllo ha esito negativo viene classificato come irreversibile perché nessuna connessione può avere esito positivo se non è possibile raggiungere il dominio per l'autenticazione in SessionHost.

FSLogixHealthCheck
  • string

Verifica che il servizio FSLogix sia operativo per assicurarsi che i profili degli utenti siano caricati nella sessione. Se questo controllo ha esito negativo viene classificato come irreversibile anche se la connessione riesce, l'esperienza utente non è ottimale perché il profilo utente non può essere caricato e l'utente otterrà un profilo temporaneo nella sessione.

MetaDataServiceCheck
  • string

Verifica che il servizio metadati sia accessibile e restituisca proprietà di calcolo.

MonitoringAgentCheck
  • string

Verifica che l'agente di Geneva richiesto sia in esecuzione. Se questo controllo ha esito negativo, non è irreversibile e il computer può comunque eseguire le connessioni al servizio. Il problema principale potrebbe essere che l'agente di monitoraggio non è presente o è in esecuzione (possibilmente) una versione precedente.

SupportedEncryptionCheck
  • string

Verifica il valore della chiave di registrazione SecurityLayer. Se il valore è 0 (SecurityLayer.RDP), il controllo ha esito negativo con codice di errore = NativeMethodErrorCode.E_FAIL ed è irreversibile. Se il valore è 1 (SecurityLayer.Negotiate), questo controllo ha esito negativo con codice di errore = NativeMethodErrorCode.ERROR_SUCCESS e non è irreversibile.

SxSStackListenerCheck
  • string

Verifica che lo stack SxS sia in esecuzione in modo che le connessioni possano avere esito positivo. Se questo controllo ha esito negativo viene classificato come irreversibile perché nessuna connessione può avere esito positivo se lo stack SxS non è pronto.

UrlsAccessibleCheck
  • string

Verifica che il servizio WVD richiesto e gli URL di Geneva siano raggiungibili da SessionHost. Questi URL sono: RdTokenUri, RdBrokerURI, RdDiagnosticsUri e URL blob di archiviazione per il monitoraggio dell'agente (geneva). Se questo controllo ha esito negativo, non è irreversibile e il computer può comunque eseguire le connessioni al servizio. Il problema principale potrebbe essere che l'agente di monitoraggio non è in grado di archiviare i dati del percorso a caldo (log, operazioni ...).

WebRTCRedirectorCheck
  • string

Verifica se il componente WebRTCRedirector è integro. Il componente WebRTCRedirector viene usato per ottimizzare le prestazioni video e audio in Microsoft Teams. In questo modo viene verificato se il componente è ancora in esecuzione e se è disponibile una versione più recente. Se questo controllo ha esito negativo, non è irreversibile e il computer può comunque eseguire le connessioni al servizio. Il problema principale potrebbe essere che il componente WebRTCRedirector deve essere riavviato o aggiornato.

HealthCheckResult

Rappresenta lo stato di integrità del controllo integrità eseguito.

Name Type Description
HealthCheckFailed
  • string

Controllo integrità non riuscito.

HealthCheckSucceeded
  • string

Controllo integrità superato.

SessionHostShutdown
  • string

È stata ricevuta una notifica di arresto.

Unknown
  • string

Il risultato del controllo integrità non è attualmente noto.

SessionHost

Rappresenta una definizione SessionHost.

Name Type Description
id
  • string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

nome della risorsa.

properties.agentVersion
  • string

Versione dell'agente in SessionHost.

properties.allowNewSession
  • boolean

Consentire una nuova sessione.

properties.assignedUser
  • string

Utente assegnato a SessionHost.

properties.lastHeartBeat
  • string

Ultimo battiti di cuore da SessionHost.

properties.lastUpdateTime
  • string

Timestamp dell'ultimo aggiornamento.

properties.objectId
  • string

ObjectId di SessionHost. (uso interno)

properties.osVersion
  • string

Versione del sistema operativo nell'host di sessione.

properties.resourceId
  • string

ID risorsa della macchina virtuale sottostante di SessionHost.

properties.sessionHostHealthCheckResults

Elenco di SessionHostHealthCheckReports

properties.sessions
  • integer

Numero di sessioni in SessionHost.

properties.status

Stato per un oggetto SessionHost.

properties.statusTimestamp
  • string

Timestamp dello stato.

properties.sxSStackVersion
  • string

Versione dello stack affiancato nell'host di sessione.

properties.updateErrorMessage
  • string

Messaggio di errore.

properties.updateState

Aggiornare lo stato di un oggetto SessionHost.

properties.virtualMachineId
  • string

ID macchina virtuale della macchina virtuale sottostante di SessionHost.

type
  • string

Tipo di risorsa. ad esempio "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SessionHostHealthCheckFailureDetails

Contiene informazioni dettagliate sull'errore.

Name Type Description
errorCode
  • integer

Codice di errore corrispondente all'errore.

lastHealthCheckDateTime
  • string

Timestamp dell'ultimo aggiornamento.

message
  • string

Messaggio di errore: suggerimenti sugli errori e su come eseguire il ripristino.

SessionHostHealthCheckReport

Report per le informazioni sull'host della sessione.

Name Type Description
additionalFailureDetails

Informazioni dettagliate aggiuntive sull'errore.

healthCheckName

Rappresenta il nome dell'operazione di controllo dell'integrità eseguita.

healthCheckResult

Rappresenta lo stato di integrità del controllo integrità eseguito.

Status

Stato per un oggetto SessionHost.

Name Type Description
Available
  • string

L'host sessione ha superato tutti i controlli di integrità ed è disponibile per gestire le connessioni.

Disconnected
  • string

L'host sessione non è disponibile perché è attualmente disconnesso.

DomainTrustRelationshipLost
  • string

Relazione di trust di dominio di SessionHost persa

FSLogixNotHealthy
  • string

FSLogix è in uno stato non integro nell'host sessione.

NeedsAssistance
  • string

Nuovo stato per informare gli amministratori che l'integrità dell'endpoint deve essere corretta. Le connessioni potrebbero non riuscire, in quanto questi problemi non sono irreversibili.

NoHeartbeat
  • string

L'host sessione non ha problemi di memoria.

NotJoinedToDomain
  • string

SessionHost non è aggiunto al dominio.

Shutdown
  • string

Host sessione arrestato: l'host di sessione segnalato da Agente Desktop remoto deve essere arrestato o deallocato.

SxSStackListenerNotReady
  • string

Lo stack SxS installato in SessionHost non è pronto per ricevere le connessioni.

Unavailable
  • string

L'host di sessione è disattivato o non ha superato i controlli di integrità critici che causano il fatto che il servizio non è in grado di instradare le connessioni a questo host di sessione. Si noti che sostituisce lo stato "NoHeartBeat" precedente.

UpgradeFailed
  • string

L'host sessione non è disponibile perché l'aggiornamento del componente critico (agente, stack side-by-side e così via) non è riuscito.

Upgrading
  • string

L'host sessione non è disponibile perché è in corso un aggiornamento di RDAgent/stack side-by-side. Nota: questo stato verrà rimosso al termine dell'aggiornamento e l'host sarà in grado di accettare le connessioni.

UpdateState

Aggiornare lo stato di un oggetto SessionHost.

Name Type Description
Failed
  • string
Initial
  • string
Pending
  • string
Started
  • string
Succeeded
  • string