Microsoft KB Archive/320191

= HOW TO: Use the SHADOW Command to Remotely Monitor an Active Session of Another User in Windows 2000 Terminal Services =

Article ID: 320191

Article Last Modified on 10/30/2006

-

APPLIES TO


 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Professional Edition

-



This article was previously published under Q320191



IN THIS TASK
SUMMARY SHADOW Command Syntax
 * Example

How to Configure Remote Control Settings Troubleshooting REFERENCES



SUMMARY
This step-by-step article describes how to use the shadow command to remotely monitor and control another user's Terminal Services session. You can use the shadow command to view or actively control an active session of another user. If you actively control a user's session, you can input keyboard and mouse actions for that session.

back to the top

SHADOW Command Syntax
{ |  } [/server: ] [/v]

The following list describes the parameters that you can use with the shadow command:
 *  : Use this parameter to specify the name of the session that you want to remotely control.
 *  : Use this parameter to specify the identification number (ID) of the session that you want to remotely control.
 * /server: : Use this parameter to specify the Terminal server that contains the session that you want to remotely control. By default, the current Terminal server is used.
 * /v : Use this parameter to display information about the actions that are being performed.

back to the top

Example
  To display a list of sessions and their session IDs, type query user at the command line on the server, and then press ENTER. The following output is displayed:  USERNAME             SESSIONNAME        ID  STATE   IDLE TIME  LOGON TIME tester               console             0  Active. 3/26/2002 11:17 AM >tester               rdp-tcp#3           1  Active. 3/26/2002 4:02 PM tester               rdp-tcp#6           2  Active         12  3/27/2002 8:44 AM                     To shadow session 2, type shadow 2. To shadow the session rdp-tcp#3, type shadow rdp-tcp#3.

Before you can monitor another session, the user of the other session receives the following message (unless you disable this warning):

\\ \ is requesting to control your session remotely.

Do you accept the request?

Your session may stop responding (hang) for a few seconds while the server waits for a response from the user. Press CTRL+* to end the remotely controlled session (use the asterisk [*] from the numeric keypad only).

You can also define a hot key in Terminal Services Manager to end the remotely controlled session.

NOTES:
 * You can always remotely control your own sessions (except for the current session); however, you must have Full Control access permissions to remotely control another session.
 * Your session must be able to support the video resolution that is used for the session that you are remotely controlling. If your session cannot support the video resolution of this session, you cannot remotely control the session.
 * While you are in this console session, you cannot remotely control another session and your session cannot be remotely controlled by another session.
 * You can also use the remote control functionality to observe or actively control another session.

back to the top

How to Configure Remote Control Settings
To configure remote control for users and sessions, use either Terminal Services Configuration or the Terminal Services extensions to Local Users and Groups and the Terminal Services extensions to Active Directory for Users and Computers.

To configure remote control settings:
 * 1) Click Start, point to Programs, point to Administrative Tools, and then click Terminal Services Configuration.
 * 2) In the console tree, click Connections.
 * 3) Right-click the connection for which you want to configure remote control in the details pane, and then click Properties.
 * 4) Click the Remote Control tab, and then click Use remote control with the following settings to configure remote control for the connection.
 * 5) To configure remote control so that a message is displayed on the client computer that prompts the user for permission to view or take part in the session, click to select the Require user's permission check box.
 * 6) Under Level of control, click either of the following options:
 * 7) * View the session: Click this option to specify that the user's session can be viewed only.

-or-
 * 1) * Interact with the session: Click this option to specify that the user's session can be actively controlled with your keyboard and mouse.

back to the top

Troubleshooting
 If you try to run the shadow command, you may receive the following error message:

Remote control failed. Error code 7044

Error [7044]:The request to control another session remotely was denied.

This message occurs if either there is no response from the computer that is to be monitored or if the request is refused. Before monitoring begins, the server prompts the user that the session is about to be remotely controlled, (unless you turned off this warning). The user of the computer that is to be monitored receives the following message:

\\ \ is requesting to control your session remotely.

Do you accept the request?

Click Yes on the computer that is to be monitored to allow the session to be monitored.

For more information about how to configure remote control settings, see the Configure Remote Control Settings section of this article. If you try to run the shadow command from the console session, you may receive the following error message:

Remote control failed. Error code 7050

Error [7050]:The requested session cannot be controlled remotely.

This may be because the session is disconnected or does not currently have a user logged on.

This error message occurs because you cannot remotely control another session while you are in this console session and your session cannot be remotely controlled by another session.</li></ul>

back to the top

<div class="references_section">