API script command: start_vpro_session

The start_vpro_session command initiates a vPro session on the target machine using the specified Jumpoint.

Required parameters for the start_vpro_session command

target=[string]

The hostname or IP address of the machine targeted for a vPro session.

jumpoint=[string]

The Jumpoint through which to start the vPro session. This Jumpoint must be on the same subnet as the target computer and must be configured for vPro support.

To initiate a vPro session using BeyondTrust Client Scripting, you must specify the target machine's hostname or private IP. (If Kerberos is used for vPro authentication, then the fully qualified domain name must be specified.) The Jumpoint name must also be specified. See the query examples below.

Optional parameter for the start_vpro_session command

session.custom.[custom field]=[string]

The code name and value of any custom fields. These fields must first be configured in /login > Management > API Configuration.

Each attribute must be specified as a different parameter. Each custom field has a maximum length of 1024 characters. The maximum total size of all combined custom fields, including the external key, must be limited to 10KB.

Query examples: start_vpro_session

Start a vPro session with the computer "ABCDEF02" through the Jumpoint "Network01"

https://support.example.com/api/client_script?type=rep&operation=generate&action=start_vpro_session&target=ABCDEF02&jumpoint=Network01

Start a vPro session with the computer "ABCDEF02" through the Jumpoint "Network01" and associate custom attributes with the session

https://support.example.com/api/client_script?type=rep&operation=generate&action=start_vpro_session&target=ABCDEF02&jumpoint=Network01&session.custom.custom_field1=Custom%20Value&session.custom.custom_field2=123