Shadow

Applies To: Windows Server 2008, Windows Server 2008 R2, Windows Vista

Enables you to remotely control an active session of another user on a Remote Desktop Session Host (RD Session Host) server.

For examples of how to use this command, see Examples.

Note

In Windows Server 2008 R2, Terminal Services was renamed Remote Desktop Services. To find out what's new in this version, see What’s New in Remote Desktop Services on the Windows Server TechCenter.

Syntax

shadow {<SessionName> | <SessionID>} [/server:<ServerName>] [/v]

Parameters

Parameter Description

<SessionName>

Specifies the name of the session that you want to remotely control.

<SessionID>

Specifies the ID of the session that you want to remotely control. Use query user to display the list of sessions and their session IDs.

/server:<ServerName>

Specifies the RD Session Host server containing the session that you want to remotely control. By default, the current RD Session Host4 server is used.

/v

Displays information about the actions being performed.

/?

Displays help at the command prompt.

Remarks

  • You can either view or actively control the session. If you choose to actively control a user's session, you will be able to input keyboard and mouse actions to the session.

  • You can always remotely control your own sessions (except the current session), but you must have Full Control permission or Remote Control special access permission to remotely control another session.

  • You can also initiate remote control by using Remote Desktop Services Manager.

  • Before monitoring begins, the server warns the user that the session is about to be remotely controlled, unless this warning is disabled. Your session might appear to be frozen for a few seconds while it waits for a response from the user. To configure remote control for users and sessions, use the Remote Desktop Services Configuration tool or the Remote Desktop Services extensions to Local Users and Groups and Active Directory Users and Computers.

  • Your session must be capable of supporting the video resolution used at the session that you are remotely controlling or the operation fails.

  • The console session can neither remotely control another session nor can it be remotely controlled by another session.

  • When you want to end remote control (shadowing), press CTRL+* (by using * from the numeric keypad only).

Examples

  • To shadow session 93, type:

    shadow 93
    
  • To shadow the session ACCTG01, type:

    shadow ACCTG01
    

Additional references

Command-Line Syntax Key

Remote Desktop Services (Terminal Services) Command Reference