How to use the client Command Line Parameters

[dasupport]

This is directly from the help file on how to use command line parameters.

Client Command Line Parameters

The Beyond Remote client application will allow you to pass in command line parameters. This will, for example allow you to start a remote desktop session from a shortcut on your desktop.

Command line parameters

/ConType - This parameter allows you to specify the connection type and is required when using command line parameters.

0 = Standard Beyond Remote desktop session
1 = Terminal Server session
2 = Windows XP Remote Desktop session
3 = File Transfer
4 = Chat
5 = Open programs and/or documents on the Beyond Remote server
6 = Wake-On-Lan

Usage: /ConType=0

/Host - This parameter allows you to specify the remote computer you want to connect to and is a required parameter. You can specify a host name or IP address.

Usage: /Host=192.168.0.1 OR /Host=AComputerName

Beyond Remote desktop session specific parameters

/Pass - Allows you to specify the password that is used to authenticate with the remote computer. If this parameter is not used then you will be prompted for a password.

/Port - Allows you to specify the port used to connect to the remote computer. If none is specified then the default port of 5424 will be used.

/ViewMode - Allows you to specify if this session will be full control or viewing only. If none is specified then a default of 0 (Full control) will be used.

0 = Full Control (default)
1 = Viewing only

/ScreenMode - Allows you to specify the startup screen mode. If none is specified then the remote session will be started in scaled mode.

0 = Scaled (default)
1 = Normal
2 = Full Screen
3 = Scaled Full Screen

/ColorMode - Allows you to specify the startup color mode. If none is specified then a default of 256 colors will be used.

0 = 16 Colors
1 = 256 Colors (default)
2 = 16k Colors
3 = Maximum Colors (32k colors is available)

/BlockSize - Allows your to specify the block sampling rate. If none is specified then a default of 16k will be used.

0 = 8k Blocks
1 = 16k Blocks (default)
2 = 32k Blocks
3 = 64k Blocks

/FPS - Allows you to specify the frames per second (FPS) rate. If none is specified a default of maximum will be used.

0 = 2 fps
1 = 5 fps
2 = 10 fps
3 = 15 fps
4 = 20 fps
5 = 25 fps
6 = Maximum available (default)

Terminal Server and Windows XP Remote Desktop Specific Parameters

/TSXPResolution - Allows you to specify the resolution of the remote desktop. If none is specified then a default of 640x480 will be used.

0 = 640x480 (default)
1 = 800x600
2 = 1024x768
3 = 1280x1024
4 = 1600x1200

/TSXPStartupMode - Allows you to specify the startup screen mode. If none is specified then a default of windowed will be used.

0 = Windowed (default)
1 = Full screen

Starting/Opening programs and/or documents on the server

/File - Allows you to specify a full path and name of an executable or document on the remote computer. Note: If the file is located in the system path you can skip specifying the path.

/StartupDir - Allows you to specify the startup directory the application will use when running.

/Params - Allows you to pass in command line parameters to the program you want to launch.

Wake-On-Lan Specific Parameters

/MACAddress - Allows you to specify the MAC address of the remote computer you want to wake.

Usage Examples

The examples below will assume that you have installed the client in the default location of C:\Program Files\DataApples\BeyondRemote.

The first thing you'll need to do is to create a shortcut. To do this, right click on the desktop select NEW and then SHORTCUT. A dialog box will now appear, click the BROWSE button and navigate your way to the Beyond Remote client application located at C:\Program Files\DataApples\BeyondRemote\BRClient.exe and then click the NEXT button. You will then be prompted to give it a name, I'd suggest the name of the computer you want to connect to. Next, click the FINISH button.

You should now have an icon on your desktop, right click on it and select properties, a dialog box will now appear. You should now see a field called "Target" with the full path to the Beyond Remote client application. This is where you will add your command line parameters. NOTE: There may be quotes " around the file path you will want to add a space after the ending quote and then start your parameters, each separated with a space. Here are some examples.

This example will connect to a Beyond Remote server at IP address 192.168.0.10.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=0 /host=192.168.0.10

Here's how you would specify the password.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=0 /host=192.168.0.10 /pass=mypassword

You can continue specifying parameters, just remember to separate them with spaces.

This example will start a Beyond Remote file transfer session.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=3 /host=192.168.0.10

OR

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=3 /host=192.168.0.10 /pass=mypassword

This example will open Notepad on the Beyond Remote server

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=5 /host=192.168.0.10 /file=c:\windows\notepad.exe

This example will open a web site on the Beyond Remote server

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=5 /Host=192.168.0.10 /file=http://www.dataapples.com

This example will wake-on-lan a computer on your local network

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=6 /MACAddress=000000AABBCC

This example will wake-on-lan a computer on a remote network

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=6 /host=192.168.0.10 /MACAddress=000000AABBCC

This example will start a Beyond Remote chat session.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=4 /host=192.168.0.10

OR

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=4 /host=192.168.0.10 /pass=mypassword

This example will connect to a terminal server with a resolution of 800x600 and full screen.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=1 /host=192.168.0.10 /TSXPResolution=1 /TSXPStartupMode=1

This example will connect to a Windows XP Remote Desktop with a resolution of 1024x768 in windowed mode.

C:\Program Files\DataApples\BeyondRemote\BRClient.exe /ConType=2 /host=192.168.0.10 /TSXPResolution=1 /TSXPStartupMode=0
_________________
Michael Berg
Data Apples Technical Support
support@dataapples.com