How to Shadow across multiple host pools and multiple users

**Update 07/07/2020**
The below multi host pool, multi user shadowing tool now supports both Spring and Fall Releases in the same tool.

I get a lot of customer questions about how to shadow user sessions in Windows Virtual Desktop, and so I started listing the various options on Twitter and LinkedIn.


These options all work fine, but they all require you as the admin to go into the tooling and finding the specific Session Host name and Session ID in order to shadow it. I often get asked: "is there a GUI that shows all sessions across my estate and I can just connect to it directly?"

Well there is a tool that make this much easier.
This tool was created by Garry Down from Ultima who are a great Microsoft and Windows Virtual Desktop partner, and so deserves credit for this.

This is a PowerShell based tool that will log into your WVD tenant and list all Host Pools and all user sessions running on those pools. You can then just select the user name that you want to shadow and then connect. 

Once running you use the first drop down box to choose your host pool:

It lists all your Host pools: 

Once you select your Host Pool, it will show all of the connected user sessions:

You then just need to click on the User Name - you don't need to know the Session host or Session ID, then Shadow user and you then connect through to that session.

Selecting "Allow Remote Control of the Users Session" enables you to drive the session, without enabling this you will just see the result of the users actions.

The end user still needs to allow the shadowing:

You are then connected:

The user experience for this looks like this:

The PowerShell scripts are listed here. 

There are two scripts:
1. Save WVD Service Principal Password.ps1 - which will securely save your Service principal credentials locally, and, 
2. Shadow a User.ps1 - which logs into your tenant and reads your Host Pools and connected users and presents these in a GUI and then allows you to connect.

If you would rather just use your user account instead of a Service Principal you don't need to use the first script and you can just not use the section from line 72 but rather uncomment and use line 84

You also just need to add in your WVD Tenant ID in line 4

Then run the remaining part of the script to start the Shadowing GUI.


Popular posts from this blog

Reassign a WVD Personal Session Host

AVD and Azure Active Directory Domain Join public preview

How to deploy a Windows Virtual Desktop host pool using Infrastructure as code from Azure DevOps