Running Cetsc.exe (Compact 7)
3/12/2014
The Windows Embedded Compact Terminal Services Client (CETSC), Cetsc.exe, is software that enables a Windows Embedded Compact powered device to connect to a server that has Terminal Server enabled and access Windows-based applications on that server.
Syntax
cetsc.exe [<connection file>] [/v:<server[:port]>] [/admin]
[[/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.
- /admin
Connects you to the session for administering a server. Also connects you to the session logged on at the console of a server running 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>
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>.
Memory Requirements for Debugging with Cetsc.exe
A minimum of 512MB of memory is recommended for debugging RDP applications through a Cetsc.exe session. Use the IMGRAM512 environment variable to configure your run-time image for 512MB of RAM. For more information about IMGRAM512, see IMG Environment Variables.
See Also
Concepts
Remote Desktop Connection Catalog Items and Sysgen Variables