PCoIP Client Parameters¶
The table below outlines command line parameters that are available to use and customize. These parameters enable user to configure the PCoIP Client, as well as attain and send information:
Short | Long | Default Description |
---|---|---|
-? | --help |
Display help message. Set to false by default. |
-v | --version |
Print version information. Set to false by default. |
-u | --username |
Username sent to Connection Broker. |
-p | --password |
Password sent to Connection Broker. |
-d | --domain |
Domain sent to Connection Broker. |
-b | --connection-broker |
Connection broker URL. |
-l | --log-level |
Unset force log level (will override config/registry) |
-w | --windowed |
False run inside a window. |
-f | --fullscreen |
False run in full-screen mode. The default is to run in windowed mode. |
-s | --security-mode |
Security mode. |
- | --locale |
Set locale. |
- | --disable-usb |
Disable USB. |
-h | --hard-host |
Hard host URL. This option is ignored if connection-broker is provided |
--quit-after-disconnect |
Do no re-enter the pre-session after leaving the in-session. | |
--usb-auto-forward |
Auto-forward all non-HID devices. | |
--vidpid-auto-forward |
String of VID, PID hex values separated by a comma. For example 0x540c 0x04ce wont work, you need to write 0x540c,0x04ce. | |
--vidpid-black-list |
Blocks specific VID,PIDs from autoforward regardless of whether the usb-auto-forward parameter or the USB dialog is used. |
|
--disable-menubar |
Disables the PCoIP Client menubar. Prevents the user from accessing menu functionality. | |
--disable-hotkeys |
Disables session hot keys. | |
--full-screen |
Activates full-screen mode from windowed mode in a PCoIP Session. | |
--set-host-resolution |
Locks the resolution of your host application displays. | |
--enable-scaling |
Enables scaling on the PCoIP Client without having to specify the desktop resolution. | |
--maintain-aspect-ratio |
Maintains the aspect ratio between the host and client. | |
--force-native-resolution |
Sets the resolution of the client monitor to the native resolution when the session client's launched. | |
--desktop |
Enables users to select which desktop they which to use. | |
For example, running the --help
command will have the following format:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --help
Customizable Session Features¶
The following section outlines the PCoIP session features that you can customize and configure when in a PCoIP session. The following features are outlined:
- Session Menu Bar Visibility
- Disable Hot Keys
- Windowed or Fullscreen Mode
- Set Host Resolution
- Image Scaling
- Maintain Aspect Ratio
- Force Native Resolution
Examples show command-line usage
Some of the examples shown here invoke the PCoIP Software Client via the command line. You can also set these priorities when invoking the PCoIP Software Client programmatically.
Session Menu Bar Visibility¶
To enhance the user experience the PCoIP Session Client enables the menu bar by default, however some use cases may require that it be disabled, or hidden, in order to prevent the user from accessing menu functionality. To disable the menu bar feature use the disable-menubar
parameter, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --disable-menubar
Disable Hot Keys¶
To improve usability, session hot keys, such as Ctrl+Delete+F12 (which disconnects a PCoIP session) are available to users by default. The parameter for this feature is disable-hotkeys
, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --disable-hotkeys
Windowed or Fullscreen Mode¶
You can display the PCoIP session in either windowed or fullscreen mode. Fullscreen mode enables the display topology to support multiple monitors as an extended desktop; windowed mode gives you the flexibility to display multiple application windows in parallel and switch between them quickly. Windowed mode is the default mode, and to activate fullscreen mode use the full-screen
parameter, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --full-screen
Set Host Resolution¶
Normally, the PCoIP session opens with arbitrary window dimensions. In some cases, a user may want to lock the resolution of the host application displays. This ensures the user’s viewing experience is consistent across different monitors and their native resolutions. The parameter for this feature is set-host-resolution
, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --set-host-resolution
- Host Resolution Limitations: It is only possible to specify one target resolution for all displays. The host resolution will not perform to its optimal capability if you have monitors with different resolutions.
Image Scaling¶
The image scaling feature enables scaling on the PCoIP Client without having to specify the desktop resolution. You can apply image scaling when the resolution of the PCoIP Client monitor is not the same as the resolution provided by the host. This feature provides a smoother process for image scaling on the client. The parameter for this feature is enable-scaling
, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --enable-scaling
Maintain Aspect Ratio¶
If the host and PCoIP Client aspect ratios do not match, and the maintain-aspect-ratio
parameter is not used, then the display will be stretched to fit. The parameter for this feature is maintain-aspect-ratio
. If the native aspect ratios of the host’s display and the PCoIP Client’s display do not match, the host’s aspect ratio will be preserved and will appear in the PCoIP session with black bars either on the sides or top and bottom of the display. The parameter for this feature is maintain-aspect-ratio
, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --maintain-aspect-ratio
Force Native Resolution¶
The resolution of the PCoIP Client monitor can be set to the native resolution when the session client is launched using the force-native-resolution
parameter, as outlined in the following example:
"c:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" --force-native-resolution
Launching PCoIP Software Client with a URI¶
It is possible to launch the PCoIP Software Client with a URI. The Teradici URI uses JSON Web Tokens (JWT). For more information on the use of JWT, see here. The URI is defined as the following:
pcoip://[broker]/connect[?data={jwt}]
When additional parameters are passed through the encoded JWT a session can be launched:
Field | Description | Optional vs Required |
---|---|---|
pcoip:// | Scheme registered to operating system so that PCoIP Client can be launched | Required |
broker | Broker through which a PCoIP session is supposed to be brokered through | Optional |
/connect | Connecting to a PCoIP Client with the parameters defined in "?data" | Required |
?data | Query parameter to store a jwt encoded user credentials | Optional |
The table below details supported optional JWT payload claims:
Claim | Description |
---|---|
usr | Username |
dom | Domain |
vm | Virtual machine/resource name |
sid | Broker JSESSIONID |
Below is an example of a JWT payload:
{ "usr": "username", "dom": "mydomain.com", "vm": "mydesktopname" }
pcoip://fake.broker.com/connect?data=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c3IiOiJ1c2VybmFtZSIsImRvbSI6Im15ZG9tYWluLmNvbSIsInZtIjoibXlkZXNrdG9wbmFtZSJ9.Mf3uoeZT8VQbVq7Gp0QQGbh8EqYtrIlp_E9jF2iI31Q