Home > Commands N-Z > Commands T

TSCON


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Connects to another session.


Syntax

TSCON /?

TSCON session_id | session_name [/dest:server_name] [/password:pw] [/v]


Parameters
session_id (NT2000)
The ID of the session to which you want to connect. If you use the optional /dest:server_name parameter, this is the ID of the session to which you want to connect.
session_name (NT2000)
The name of the session to which you want to connect.

Switches
/? (NT2000)
Displays help.
/dest:server_name (NT2000)
Specifies the name of the current session. This session will disconnect when you connect to the new session.
/password:pw (NT2000)
The password of the user who owns the session to which you want to connect. This password is required when the connecting user does not own the session.
/v (NT2000)
Displays information about the actions being performed.


Related

none.


Notes

You must have Full Control access permission or Connect special access permission to connect to another session.

The /dest:server_name parameter allows you to connect the session of another user to a different session.

If you do not specify a password in the /password parameter, and the target session belongs to a user other than the current one, tscon fails.

You cannot connect to the console session.


Examples

To connect to session 9 on the current terminal server and disconnect the current session, type:

    TSCON 9

To connect to session 11 on the current terminal server, using the password "secret", and disconnect the current session, type:

    TSCON 11 /password:secret

To connect the session named TERM01 to the session named TERM02, and then disconnect session TERM05, if it is connected, type:

    TSCON TERM01 /dest:TERM02 /v

Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NT2000 NTXP NT2003

Last Updated: 2006/07/01
Direct corrections or suggestions to: Rick Lively 1