garrydown / avd-shadowing

Scripts to allow an Administrator or Helpdesk User to Shadow a users AVD Session

AVD \ WVD Shadowing

Providing Remote Support, Shadowing, for a WVD Session is currently not available 'Out of the Box' in AVD

To Shadow a use you can use either Remote Assist or MSTSC, on a Client Device Remote Assist is enabled by Default but needs to be enabled in a Server OS

Remote Assist

The following command is used to run MSTSC:

msra.exe /OfferRa 'Session Host FQDN' 'Users UPN':'Session ID'

MSTSC.exe

The following command is used to run MSTSC:

mstsc.exe /v:'Session Host FQDN' or 'IP' /shadow:'Session ID'

There are two additional, optional switches

• /noConsentPrompt
  Allows you to connect to the users session without them being prompted to all the connection
  Note: If the GPO Setting Set rules for remote control of Remote Desktop Services user sessions is set to force the Consent Prompt then this switch has no effect
• /Control
  Allows you to interact with the users session (if not set – a users session is in view mode only)

This means Support have to find out the Users UPN, which Session Host the User is connected too and their Session ID to be able to run this command

Therefore, I wrote these PowerShell scripts to automate this process

Version	Description
v1.0	Initial version that only supported the Fall Edition, using a Service Principal ID to connect to the WVD Management Plane
v1.1	Updated to allow Authentication to the WVD Management Plane to be via User Account as well as Service Principal ID
v2.0	Updated to support both the Fall and Spring Releases of WVD
v2.1	Bug Fixes Applied
v3.0	Updated to Support the Use of Remote Assist as well as MSTSC Updated to support AVD being hosted in more than one Azure Subscription Support for Fall Release REMOVED

avd-shadowing's Issues

Error in Script

Gather Host Pools Function

I get the following error and I have the variables correctly set. Please help. I really want to use this code then implement for a big client.

The property 'text' cannot be found on this object. Verify that the property exists and can be set.
At C:\Users\ericd\Downloads\New Script\AVD Shadowing.ps1:243 char:5

• $Subscriptions.text          = $AVDSubscriptions
  

• ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  

  • CategoryInfo : InvalidOperation: (:) [], RuntimeException
  • FullyQualifiedErrorId : PropertyNotFound

Gather_HostPools : The term 'Gather_HostPools' is not recognized as the name of a cmdlet, function, script file, or
operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try
again.
At C:\Users\ericd\Downloads\New Script\AVD Shadowing.ps1:245 char:5

• Gather_HostPools
  

• ~~~~~~~~~~~~~~~~
  

  • CategoryInfo : ObjectNotFound: (Gather_HostPools:String) [], CommandNotFoundException
  • FullyQualifiedErrorId : CommandNotFoundException