View KiXtart Macros
RDP Client
This module allows you to configure RDP clients from a centralized location. This module supports RDP versions 4.0 (Windows NT Client), 5.0 (Windows 2000 Client), 5.1 (Windows XP Client), and 5.2 (Windows 2003 Client).

Filter:
Select the name of the filter you want assigned to this configuration element.

Action:
Select one of the following actions:
Create - Creates a new RDP connection.
Delete - Deletes an existing RDP connection.

NOTE: If a client machine has more than one version of the RDP client installed, precedence is given to the newest version. For example, if a client machine has both RDP 4.0 and RDP 5.2 installed, connections will be created and deleted for the RDP 5.2 version.

Overwrite Existing Connection:
When this option is selected, existing RDP connections will be overwritten. This option is only available if Create is selected as the Action.

Connection Name:
Enter the name of the RDP connection you want to create or delete. Subfolders can be specified by entering the relative path followed by the RDP connection name. Surrounding quotes are automatically added to the name.

Connection Location:
Select the location where the RDP connection should be created or deleted.

Computer:
Enter the name of the computer you want the RDP client to connect to. This option is only available if Create is selected as the Action.

User Name:
Enter the user name the RDP client should use when connecting to the server. This option is only available if Create is selected as the Action.

Domain:
Enter the domain name the RDP client should use when connecting to the server. This option is only available if Create is selected as the Action.

Desktop Size:
Select the desktop size the RDP client should use. When the 80% of Screen choice is selected, the RDP desktop size is derived from the client resolution as shown in table 1. This option is only available if Create is selected as the Action.

Client Resolution RDP Desktop Size
640 x 480 640 x 480
800 x 600 640 x 480
1024 x 768 800 x 600
1280 x 1024 1024 x 768
1600 x 1200 1280 x 1024
Table 1: 80% of Screen

Colors:
Select the color depth you want the RDP client to use. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Display connection bar in full screen mode:
When this option is selected, the connection bar will be displayed across the top of the display when the RDP connection is in full screen mode. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Remote Computer Sound:
Select how you want the RDP client to handle sound. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Keyboard Combinations:
Select how you want the RDP client to handle keyboard combinations such as ALT+TAB. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Automatically Connect Disk Drives:
Selecting this option instructs the RDP client to connect disk drives. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Automatically Connect Printers:
Selecting this option instructs the RDP client to connect printers. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Automatically Connect Serial Ports:
Selecting this option instructs the RDP client to connect serial ports. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Automatically Connect Smart Cards:
Selecting this option instructs the RDP client to connect smart cards. This option applies to RDP version 5.1 and newer and is only available if Create is selected as the Action.

Start the Following Program on Connection:
Selecting this option instructs the RDP client to start a program on connection. This option is only available if Create is selected as the Action.

Path and Filename:
Enter the full path and filename of the program the RDP client should execute when connecting to the server. This option is only available if Start the Following Program on Connection is selected and Create is selected as the Action.

Start in Folder:
Enter the full path of the folder the RDP client should start in when executing a program on connection to the server. This option is only available if Start the Following Program on Connection is selected and Create is selected as the Action.

Experience:
Select the connection speed you want the RDP client to be optimized for. For RDP version 4.0 and 5.0, selecting Modem (28.8 Kbps) or Modem (56 Kbps) enables the Low Speed Connection option in the RDP client. This option is only available if Create is selected as the Action.

Reconnect if Connection is Dropped:
Selecting this option instructs the RDP client to attempt to automatically reconnect if the connection is dropped. This option applies to RDP version 5.2 and is only available if Create is selected as the Action.

Example:
Filter: Global Settings
Action: Delete
Connection Name: Accounting\Solomon
Connection Location: User Start Menu


The above example deletes the RDP connection named Solomon located in the Accounting folder in the User Start Menu.

Example:
Filter: Global Settings
Action: Create
Overwrite Existing Connection: Not Selected
Connection Name: Human Resources\Abra Suite
Connection Location: User Start Menu
Computer: ATLHR
User Name: @userid
Domain: MyDomain
Desktop Size: 80% of Screen
Colors: High Color (16 Bit)
Display connection bar in full screen mode: Not Selected
Remote Computer Sound: Bring to this Computer
Keyboard Combinations: On the Local Computer
Automatically Connect Disk Drives: Not Selected
Automatically Connect Printers: Not Selected
Automatically Connect Serial Ports: Not Selected
Automatically Connect Smart Cards: Not Selected
Start the Following Program on Connection: Selected
Path and Filename: C:\Program Files\Best Software\Abra Suite\Programs\Abra32.exe
Start in Folder: C:\Program Files\Best Software\Abra Suite\Programs
Experience: Broadband (128 Kbps - 1.5 Mbps)
Reconnect if Connection is Dropped: Selected


The above example creates a RDP connection named Abra Suite. The connection will be created in the User Start Menu in a subfolder named Human Resources. If the connection already exists, it will not be overwritten. This example leverages the KiXtart macro @userid. When Script Start executes, the @userid macro is expanded into the user's logon name. Therefore, the created RDP connection will connect to server ATLHR, use the user's logon name as the user name, use domain name MyDomain, use 80% of Screen for the desktop size, and use High Color (16 Bit) color depth. Remote Computer Sound will be brought to the local computer. Keyboard Combinations will stay on the local computer. The RDP connection will start C:\Program Files\Best Software\Abra Suite\Programs\Abra32.exe and start in the C:\Program Files\Best Software\Abra Suite\Programs folder when double clicked. This connection will be optimized for a Broadband (128 Kbps - 1.5 Mbps) network and the connection will automatically reconnect if dropped.