Tscon

 

Applies To: Windows Vista, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows 8

Connects to another session on a Remote Desktop Session Host (RD Session Host) server.

For examples of how to use this command, see Examples.

Note

In Windows Server 2008 R2, Terminal Services was renamed Remote Desktop Services. To find out what's new in the latest version, see What’s New in Remote Desktop Services in Windows Server 2012 in the Windows Server TechNet Library.

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 RD Session Host server and disconnect the current session, type:

    tscon 12
    
  • To connect to session 23 on the current RD Session Host 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

Command-Line Syntax Key

Remote Desktop Services (Terminal Services) Command Reference