Destination and Authentication

Top  Previous  Next

 

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

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

disablenla

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

 

 

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

desttype

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

could

could

destinfo

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

could

could