Initiate Session
Use this step to connect to devices over an RDP connection. See Use RDP Connection for details.
Note The Initiate Session step waits until the connection is established before continuing robot execution. If remote
connection fails, an error message is provided.
Properties
- Action
- Select an action to perform by the step.
- Host
- Specify the host name to connect to.
- Account
- Specify an account name for RDP connection.
- Domain
- Specify a Domain name for RDP connection.
- Password
- Specify a password to authenticate on the remote desktop.
Note If the password or host name contains characters not accepted in an URL, such as a backslash, they must be encoded.
- Desktop size
- Set desktop geometry (WxH).
- Color depth
- Set connection color depth, such as 16, 32, or other.
Note Always use the same explicitly-specified resolution and color depth parameters for the RDP connection. Windows 10 does not support color depth lower than 32 bit. Therefore, the request from the RDP to change connection color depth will be ignored for this version of Windows.
- Logon dialog dismissal timeout
- Specify a number of seconds to wait before dismissing an extra screen during login. If the system you are connecting to is configured to show an extra screen when the user logs in, set a number of seconds to wait before dismissing the extra screen during login in this option. If this screen is not dismissed, the action may fail.
- Keep-awake key press interval
- Specify the number of seconds between the dummy keystrokes to keep the RDP session alive. Default is 30 seconds. To turn off keystrokes, specify zero (0).
- Additional parameters
- Specify additional parameters for the session. The following parameter is available.
Parameter
Description
/kbd:<language>
Tries to select the specified keyboard when setting up a new session. Provide either a Windows keyboard layout id or the full name of the keyboard layout. This parameter is ignored by the RDP server when the robot connects to an existing session.
Example: /kbd:german or /kbd:0x407 selects a German keyboard layout.