Customizing the SAM Remote Desktop Script

Enterprise Administration Guide › Implementing Shared Accounts › SAM Automatic Login › Customizing the SAM Remote Desktop Script

Customizing the SAM Remote Desktop Script

The SAM remote desktop script configures the Remote Desktop settings. SAM launches the remote desktop script to automatically login a user into a Windows Agentless endpoint. You can customize the SAM remote desktop script to control the application parameters.

The SAM remote desktop uses the following commands:

SetRDPOption BSTR bsName, BSTR bsType, BSTR bsValue

bsName: Specifies the name of the parameter to modify
bsType: Specifies the parameter type
bsValue: Defines the parameter value

Example: Configure the Remote Desktop application settings

The following example shows the commands you use to set the remote desktop window to full screen and re-direct the local drive to the remote endpoint drive:

Dim hwnd
Set test = CreateObject("ACLauncher.ACWebLauncher")
test.SetRDPOption "screen mode id","i","2"
test.SetRDPOption "redirectdrives","i","1"
hwnd = test.LauncheRDP("computer1", "computer1\administrator", "xxxxxx")

The following table contains the possible parameters and values that you can use to modify the Remote Desktop script:

Parameter	Type	Value	Options
alternate shell	String	c:\winnt\system32\notepad.exe	Defines the shell to use within the Terminal Services session. Use this parameter to set an alternate shell such as progman.exe. You can also use it to set the application that the user uses to login to the Terminal Server.
audiomode	Integer	2	0 - Bring audio to this computer 1 - Leave audio on remote computer 2 - Do not play audio
autoreconnection enabled	Integer	1	Automatically connect when file is opened.
connect to console	Integer	1	0 - connect to a virtual session 1 - connect to the console session
desktopheight	Integer	768	Defines the height of remote desktop in pixels
desktopwidth	Integer		Defines the width of remote desktop in pixels
disable full window drag	Integer	1	Disables window display while dragging
disable menu anims	Integer	1	Disables menu animations
disable themes	Integer	1	Disables themes in session
disable wallpaper	Integer	1	Disable wallpaper display
displayconnectionbar	Integer	1	Displays the connection bar in a full screen session
keyboardhook	Integer	2	Applies standard Windows key combinations 0 - On the local computer 1 - On the remote computer 2 - In fullscreen mode only
maximizeshell	Integer	0	Specifies to maximize any alternate shell used in the session
redirectcomports	Integer	1	Specifies to redirect client COM ports in session
redirectdrives	Integer	1	Specifies to redirect client drives in session
redirectprinters	Integer	1	Specifies to redirect client printers in session
redirectsmartcards	Integer	1	Specifies to redirect client smart cards in session
screen mode id	Integer	1	Defines the screen mode 1 - windowed 2 - fullscreen
server port	Integer	3389	Define the port number in the "full address" parameter
session bpp	Integer	16	Specifies the bit depth per session 8, 16, 24. 8 bit is valid for Windows 2000 Terminal Servers
shell working directory	String	c:\program files\microsoft office	Defines a working directory for an alternate shell if specified
smart sizing	Integer		Specifies to scale the client window display of desktop when resizing 0 or not present - do not scale 1 - Scale (Takes extra resources to scale)
winposstr	String	0,1,0,249,808,876	Specifies the "window mode" sizes - maximized versus sized.