Remote Syntax

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Remote Syntax

Remote uses the following general syntax:

remote Operation

Operations

Server

Client

Query

Server

Starts the remote service on the server where the command is to be run.

Syntax

remote /s Command UniqueID[/U[DomainName**\]UserName] [/UD** Name] [/F Color] [/B Color] [/V][/-V] [@K]

Parameters

• Command
  Specifies the command to be run on the server, with concurrent input from and output to a client that will connect later.

• UniqueID
  Specifies a unique name to distinguish this instance of the remote session from others running on the server. If the session name contains spaces it must be enclosed with quotation marks.

• /U[DomainName\]UserName
  Specifies the user name or group names that are permitted to connect to a specified session running on the server. The use of DomainName is optional. This parameter can be specified more than once to enable permissions for a broader set of users or groups. Security Remark
  • Users and groups are not authenticated when connecting to remote sessions on servers. This can create potential security vulnerability on the server.

• /UD Name
  Specifies the user name or group names that are to be denied access to a specified session running on the server.

• /F Color
  Specifies the foreground color for the session on the server. Acceptable values are: yellow, black, blue, lblue, white, red, green, cyan, and purple. Remote does not discern color conflicts between background and foreground. If the same color is specified for both background and foreground, text in the command console will not be visible.

• /B Color
  Specifies the background color for the session on the server. Acceptable values are: yellow, black, blue, lblue, white, red, green, cyan, and purple. Remote does not discern color conflicts between background and foreground. If the same color is specified for both background and foreground, text in the command console will not be visible.

• /V
  Makes the specified session visible to remote users logging in with /q parameter.

• /-V
  Makes the specified session invisible to remote users logging in with /q parameter. By default, if the command looks like a debugger, the session is visible to the remote client.

• @K
  Causes the server session to terminate.

Client

Starts the remote service on the client and connects to a specified server session based on a server name and unique identifier.

Syntax

remote /c ServerName UniqueID[/F Color] [/B Color] [/L Number] [/K][@Q]

Parameters

• ServerName
  Specifies the server name to connect to from the client.

• UniqueID
  Specifies a unique name to connect to on a specified server. If the session name contains spaces it must be enclosed in quotation marks.

• /F Color
  Specifies the foreground color for the session on the server. Acceptable values are: yellow, black, blue, lblue, white, red, green, cyan, and purple. Remote does not discern color conflicts between background and foreground. If the same color is specified for both background and foreground, text in the command console will not be visible.

• /B Color
  Specifies the background color for the session on the server. Acceptable values are: yellow, black, blue, lblue, white, red, green, cyan, and purple. Remote does not discern color conflicts between background and foreground. If the same color is specified for both background and foreground, text in the command console will not be visible.

• /L Number
  Specifies the number of lines of output to obtain from a specified session running on a remote server. Note
  • Setting a small number of lines can truncate output from the session running on the server.

• /K
  Assigns colors to highlight keywords based on information in a text file of the following format: Keyword ForegroundColor[, BackgroundColor] See "Example 2: Example of a keyword/color file" in Remote Examples. Acceptable values for ForegroundColor and BackgroundColor are: yellow, black, blue, lblue, white, red, green, cyan, and purple. Remote does not discern color conflicts between background and foreground. If the same color is specified for both background and foreground, text in the command console will not be visible.

• @Q
  Terminates the client session, leaving the remote server session running.

Query

Queries and retrieves the available unique identifiers of visible sessions on the specified computer.

Syntax

remote /Q ServerName

Parameters

• ServerName
  Specifies the server name to query.

See Also

Concepts

Remote Overview
Remote Remarks
Remote Examples
Alphabetical List of Tools
Windiff Overview
Poolmon Overview
Msizap Overview
Msicuu Overview
Memsnap Overview
Gflags.exe
Devcon Overview