Destination and Authentication

Find below all the parameters related to the connection destination and authentication.

The last three columns of the table will let you know what parameters should be sent depending on the authentication mode used.

Parameter	What it means	Type/format	Default	Profile	Digest	None
profileKey	Key that identifies a profile in order to establish the connection through it. The profileKey access key must be sent when you using "Access Profiles". You will find the key information while Editing a profile.	string profile key		must	must not	must not
computer	The remote desktop IP and port to connect to. For "None", "Username/Password" as authentication mode or for the [any computer] profile you will have to specify the computer parameter.	string IP:Port		must not	must	must
username	The remote desktop username credential.	string username		could	could	could
password	The remote desktop password credential.	string password		could	could	could
askForCredentials	The askForCredentials parameter set to true, will make sure that whenever the username or password values to authenticate against the remote machine are not available, ThinRDP will prompt the user to inform them. If the askForCredentials is set to false, no dialog will be shown to the user and in case there is no password or username to authenticate, the user will not be able to log in.	boolean true,false	false	could	could	could
overrideDefaults1	If you are using Access Profiles as authentication mode and set this property is set to true, most of the Profile settings will be overridden by the parameters sent on the Connect method.	boolean true,false	false	could	must not	must not
disablenla2	Set the option disableNLA if you use a CredSSP other than Microsoft on the Remote Machine.	boolean true,false	false	could	must not	must not

1. The properties computer, profileKey, startprg and command can not be overridden for security reasons.

2. This option will only be considered by ThinRDP if you are not using profiles as authentication mode, or for the any computer profile.

If you wish to use the integration in order to connect to a specific application/program, set the following parameters:

Parameter	What it means	Type/format	Default	Profile	Digest	None
startprg	Sets the launching application mode. Set 0 for "Do nothing" option; 1 for "Start a program" option; 2 for "Launch RemoteApp" option.	integer 0,1 or 2	0	could	could	could
command	Full remote application path that should start upon connection establishment.	string app path		could	could	could
directory	Initial context directory to be used by the application set on command parameter described above.	string dir path		could	could	could
cmdargs	Arguments to start the application specified on the "command" property.	string app args		could	could	could

If you want to establish Hyper-V or RDS collection VM connections, set the parameters below:

Parameter

What it means

Type/format

Default

Profile

Digest

None

desttype2

Set the desttype to "VMID" in case you want to establish a connection to a Hyper-V Virtual Machine or set "RDS" if you want to create a connection to an RDS Collection VM.

The connection will act as a regular connection in case you don't inform this property of inform any value different from "VMID" and "RDS".

string

VMID or RDS

could

destinfo2

Inform the Virtual Machine ID, for Hyper-V Virtual Machine connections or inform the TSV URL for RDS Collection Virtual Machines.

string

Virtual Machine ID or TSV URL

could

2. This option will only be considered by ThinRDP if you are not using profiles as authentication mode, or if you are connecting through the any computer profile.