DOCUMENT:Q186556  11-DEC-2001  [winnt]
TITLE   :Terminal Server Commands: SHADOW
PRODUCT :Microsoft Windows NT
PROD/VER:WinNT:4.0
OPER/SYS:
KEYWORDS:

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Windows NT Server version 4.0, Terminal Server Edition 
-------------------------------------------------------------------------------

SUMMARY
=======

The SHADOW function is not built into version 4 of the Terminal Server and
Terminal Server client. The SHADOW utility is included for use if Citrix
Metaframe and the Citrix ICA client are used with Terminal Server, which allows
shadowing.

Shadow allows you to monitor a session of another user. All information displayed
on the computer of the session you are shadowing also appears on your computer.

Syntax
------

shadow sessionname [/server:servername] [/v] [/?] shadow sessionID
[/server:servername] [/v] [/?]

Parameters
----------

sessionname

   Identifies the name of the session. The name was created by the system
   administrator when the session was configured.

sessionID

   Specifies the ID of the session you want to shadow. Use query user to get a
   list of sessions and their IDs.

/server:servername

   Specifies the Terminal Server to use. Otherwise, the current Terminal Server
   is used.

/v (verbose)

   Displays information about the actions being performed.

/? (help)

   Displays the syntax for this command and information about the command's
   options.

Security Restrictions
---------------------

You must have Shadow access permission for the session you want to shadow.

SHADOW -- Additional Notes

Before shadowing begins, the server warns the user that the session will be
shadowed and allows the user to confirm or deny shadowing, unless this warning
is disabled. Use Terminal Server Connection Configuration and User Manager for
Domains to configure shadowing for users and sessions. The shadowing session
must be capable of supporting the video resolution used at the shadowed session.
Otherwise, the operation fails. You cannot shadow the system console from
another session, and you cannot shadow other sessions from the system console.
Press CTRL+* (or whatever hotkey you define) to terminate shadowing..

SHADOW -- Examples

To shadow session 93, type:

   "Shadow 93" (without the quotation marks)

To shadow the session ACCTG01, type:

   "Shadow ACCTG01" (without the quotation marks)

NOTE: Shadowing is not currently supported with the Windows Terminal Server 4.0
client. To use the Shadow function, you must use the Citrix ICA Client and the
Terminal Server add-on from Citrix called Metaframe. If you attempt to shadow a
session without the ICA Client and Metaframe, you will receive the following
error:

   Shadow failed. Error code 50. Error [50]: The network request is not
   supported.

Additional query words:

======================================================================
Keywords          :  
Technology        : kbWinNTsearch kbWinNT400search kbWinNTSsearch kbWinNTS400search kbNTTermServ400 kbNTTermServSearch
Version           : WinNT:4.0
Issue type        : kbinfo

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 2001.