Tscon |
Applies To: Windows Server 2008,Windows Server 2008 R2,Windows Vista
Connects to another session on a terminal server.
For examples of how to use this command, see Examples.
Syntax
|
|
tscon {<SessionID> | <SessionName>} [/dest:<SessionName>] [/password:<pw> | /password:*] [/v] |
Parameters
Parameter |
Description |
<SessionID> |
Specifies the ID of the session to which you want to connect. If you use the optional /dest:<SessionName> parameter, this is the ID of the session to which you want to connect. |
<SessionName> |
Specifies the name of the session to which you want to connect. |
/dest:<SessionName> |
Specifies the name of the current session. This session will disconnect when you connect to the new session. |
/password:<pw> |
Specifies 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. |
/password:* |
Prompts for the password of the user who owns the session to which you want to connect. |
/v |
Displays information about the actions being performed. |
/? |
Displays help at the command prompt. |
Remarks
- You must have Full Control access permission or Connect special access permission to connect to another session.
- The /dest:<SessionName> 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 12 on the current terminal server and disconnect the current session, type:
|
|
tscon 12 |
- To connect to session 23 on the current terminal server, by using the password mypass, and disconnect the current session, type:
|
|
tscon 23 /password:mypass |
- To connect the session named TERM03 to the session named TERM05, and then disconnect session TERM05, if it is connected, type:
|
|
tscon TERM03 /v /dest:TERM05 |
Additional references
Terminal Services Command Reference