Forum Discussion

Roop_Kiran_Chevuri's avatar
Apr 21, 2020

Windows Virtual Desktop Health Check - New statuses for Get-RDSSessionHost

Windows Virtual Desktop service is rolling out changes which introduce new set of health checks for Session Host in production. These health checks determine if the Session Host is in the state where it can accept connections and highlights cases which need  administrator intervention.

Below are the statuses and what each of them should be interpreted as:

 

  • Available: Session Host has passed all the health checks and is available to handle connections
  • Unavailable: Session Host is either turned off or has failed critical health checks which is causing service not to be able to route connections to this session host. E.g. session host is not joined to the domain, failures in installing critical components like initial versions of agents, stack etc. Note this replaces previous “NoHeartBeat” status.
  • NeedsAssistance: Session Host has passed health checks which allow connectivity but failed other important health checks which limit the service functionality. E.g. required WVD URL’s are not accessible from the session host which puts the session host in an unsupported state.

Impact: Customers who have previously built reporting or tools based on Get-RDSSessionHost status would need to update their tools to reflect new statuses. 

 

Windows Virtual Desktop Scaling tool  has been updated take these statuses into consideration. You can find instructions in post here on how to update your scaling tool to latest version which contains these changes.

 

Eg: Available state

 SessionHostName    : ABC
TenantName         : ABCXYZ
TenantGroupName    : Default Tenant Group
HostPoolName       : ABCDEF
AllowNewSession    : False
Sessions           : 0
LastHeartBeat      : 4/19/2020 7:55:12 AM
AgentVersion       : 1.0.1932.3500
AssignedUser       : 
OsVersion          : 10.0.18363
SxSStackVersion    : rdp-sxs200326004
Status             : Available
UpdateState        : Succeeded
LastUpdateTime     : 4/19/2020 7:40:35 AM
UpdateErrorMessage : 

 

Eg: Unavailable state

 SessionHostName    : ABC
TenantName         : ABCXYZ
TenantGroupName    : Default Tenant Group
HostPoolName       : ABCDEF
AllowNewSession    : False
Sessions           : 0
LastHeartBeat      : 4/13/2020 11:26:22 PM
AgentVersion       : 1.0.1800.1300
AssignedUser       : 
OsVersion          : 10.0.18363
SxSStackVersion    : rdp-sxs200326004
Status             : Unavailable
UpdateState        : Succeeded
LastUpdateTime     : 4/13/2020 7:01:08 PM
UpdateErrorMessage :

 

Eg: Needs Assistance

SessionHostName    : ABC

TenantName         : ABCXYZ

TenantGroupName    : Default Tenant Group

HostPoolName       : ABCDEF

AllowNewSession    : True

Sessions           : 8

LastHeartBeat      : 4/17/2020 7:55:12 AM

AgentVersion       : 1.0.1932.3500

AssignedUser       :

OsVersion          : 10.0.18363

SxSStackVersion    : rdp-sxs200326004

Status             : NeedsAssistance

UpdateState        : Succeeded

LastUpdateTime     : 4/13/2020 9:25:57 PM

UpdateErrorMessage :

 

9 Replies

Resources