Running Cetsc.exe
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
The Windows Embedded CE Terminal Services Client (CETSC), Cetsc.exe, is software that enables a Windows Embedded CE device to connect to a server that has Terminal Server enabled and access Windows-based applications on that server.
cetsc.exe [<connection file>] [/v:<server[:port]>] [/console]
[[/f] | [/w:<width> /h:<height>] | [/span]] [/edit "connection file"] [/migrate] [/s <Connection name>] | /?
Parameters
- <connection file>
Specifies the name of the .rdp file that contains the settings for the connection.
- /v: server[: port]
Specifies the remote computer and, optionally, the port number to which you want to connect.
- /console
Connects to the console session of the specified Windows 2000 Server or Windows Server 2003.
- /f
Starts Remote Desktop in full-screen mode.
- /w: <width>
Specifies the width of the Remote Desktop window.
- /h: <height>
Specifies the height of the Remote Desktop window.
- /span
Specifies to match the Remote Desktop width and height with the local virtual desktop, spanning across multiple monitors if it is necessary. To span across monitors, the monitors must all have the same height and be aligned vertically.
- /edit " connection file "
Opens the specified .rdp connection file for editing.
- /migrate
Migrates legacy connection files that were created by using Client Connection Manager to new .rdp connection files.
- /s <Connection name>
Connects by using the connection that is defined in the registry under HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\<Connection name>.
- /?
Displays a Help message that shows the syntax and describes the options for cetsc.exe.
Remarks
The following command example shows you how to connect to MyServer by using the MyRdpFile.rdp connection file that is located in the root directory.
cetsc.exe MyRdpFile.rdp /v:MyServer
If the .rdp connection file is not located in the root directory, you must specify the path of the file. The following command example shows you how to specify the path.
cetsc.exe \Windows\MyRdpFile.rdp /v:MyServer
Connect by Using Registry Settings
Cetsc.exe can be configured to use connection settings either from an .rdp file or from the registry.
If you are using the Windows Thin Client Shell, the connection settings are saved in the registry. Typically, you would modify the Project.reg file or the rdp.reg file before you build and download the run-time image. For cetsc.exe to use connection settings in the registry, you must add the following registry key to rdp.reg for the connection.
HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client\< Connection name >
Under this registry key, you can add the values that are shown in Configuring the Terminal Services Client.
In the cetsc.exe syntax options, /s <Connection name> identifies the registry key where the desired RDP connection settings are stored. To connect to a server by using settings in a registry key, at a command prompt, type the following command:
cetsc /s <Connection name>
When this command is executed, cetsc.exe reads the connection settings from HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\<Connection name>.
See Also
Concepts
RDP OS Design Development
Terminal Services Client Configuration through the .rdp File