ICA policy settings
The ICA section contains policy settings related to ICA listener connections and mapping to the clipboard.
Adaptive transport
This setting allows or prevents data transport over EDT as primary and fallback to TCP.
By default, adaptive transport is disabled (Off) and TCP is always used.
- In Studio, enable the policy setting, HDX adaptive transport (it is disabled by default). We also recommend that you do not enable this feature as a universal policy for all objects in the Site.
- To enable the policy setting, set the value to Preferred, then click OK.
Preferred. Adaptive transport over EDT is used when possible, with fallback to TCP.
Diagnostic mode. EDT is forced on and fall back to TCP is disabled. We recommend this setting only for troubleshooting.
Off. TCP is forced on, and EDT is disabled.
For more information, see Adaptive transport.
Application launch wait timeout
This setting specifies the wait timeout value in milliseconds for a session to wait for the first application to start. If the start of the application exceeds this time period, the session ends.
You can choose the default time (10000 milliseconds) or specify a number in milliseconds.
Client clipboard redirection
This setting allows or prevents the clipboard on the user device being mapped to the clipboard on the server.
By default, clipboard redirection is allowed.
To prevent cut-and-paste data transfer between a session and the local clipboard, select Prohibit. Users can still cut and paste data between applications running in sessions.
After allowing this setting, configure the maximum allowed bandwidth the clipboard can consume in a client connection using the Clipboard redirection bandwidth limit or the Clipboard redirection bandwidth limit percent settings.
Client clipboard write allowed formats
When the Restrict client clipboard write setting is Enabled, host clipboard data cannot be shared with the client endpoint. You can use this setting to allow specific data formats to be shared with the client endpoint clipboard. To use this setting, enable it and add the specific formats to be allowed.
The following clipboard formats are system defined:
- CF_TEXT
- CF_BITMAP
- CF_METAFILEPICT
- CF_SYLK
- CF_DIF
- CF_TIFF
- CF_OEMTEXT
- CF_DIB
- CF_PALETTE
- CF_PENDATA
- CF_RIFF
- CF_WAVE
- CF_UNICODETEXT
- CF_ENHMETAFILE
- CF_HDROP
- CF_LOCALE
- CF_DIBV5
- CF_OWNERDISPLAY
- CF_DSPTEXT
- CF_DSPBITMAP
- CF_DSPMETAFILEPICT
- CF_DISPENHMETAFILE
- CF_HTML
The following custom formats are predefined in XenApp and XenDesktop:
- CFX_RICHTEXT
- CFX_OfficeDrawingShape
- CFX_BIFF8
HTML format is disabled by default. To enable this feature:
- Ensure Client clipboard redirection is set to allowed.
- Ensure Restrict client clipboard write is set to enabled.
- Add an entry for CF_HTML (and any other formats you want supported) in Client clipboard write allowed formats.
Note: Enabling HTML format clipboard copy support (CF_HTML) copies any scripts (if they exist) from the source of the copied content to the destination. Check that you trust the source before proceeding to copy. If you do copy content containing scripts, they are live only if you save the destination file as an HTML file and execute it.
Additional custom formats can be added. The custom format name must match the formats to be registered with the system. Format names are case-sensitive.
This setting does not apply if either Client clipboard redirection or Restrict client clipboard write is set to Prohibited.
Desktop launches
This setting allows or prevents non-administrative users in a VDA Direct Access Users group connecting to a session on that VDA using an ICA connection.
By default, non-administrative users cannot connect to these sessions.
This setting has no effect on non-administrative users in a VDA Direct Access Users group who are using an RDP connection. These users can connect to the VDA whether this setting is enabled or disabled. This setting has no effect on non-administrative users not in a VDA Direct Access Users group. These users cannot connect to the VDA whether this setting is enabled or disabled.
ICA listener connection timeout
Note: This setting applies only to Virtual Delivery Agents 5.0, 5.5, and 5.6 Feature Pack 1.
This setting specifies the maximum wait time for a connection using the ICA protocol to be completed.
By default, the maximum wait time is 120000 milliseconds, or two minutes.
ICA listener port number
This setting specifies the TCP/IP port number used by the ICA protocol on the server.
By default, the port number is set to 1494.
Valid port numbers must be in the range of 0-65535 and must not conflict with other well-known port numbers. If you change the port number, restart the server for the new value to take effect. If you change the port number on the server, you must also change it on every Citrix Receiver or plug-in that connects to the server.
Launching of non-published programs during client connection
This setting specifies whether to allow starting initial applications through RDP on the server.
By default, starting initial applications through RDP on the server is not allowed.
Logoff checker startup delay
This setting specifies the duration to delay the logoff checker startup. Use this policy to set the time (in seconds) that a client session waits before disconnecting the session.
This setting also increases the time it takes for a user to log off the server.
Restrict client clipboard write
If this setting is Allowed, host clipboard data cannot be shared with the client endpoint. You can allow specific formats by enabling the Client clipboard write allowed formats setting.
By default, this setting is Prohibited.
Restrict session clipboard write
When this setting is Allowed, client clipboard data cannot be shared within the user session. You can allow specific formats by enabling the Session clipboard write allowed formats setting.
By default, this setting is Prohibited.
Session clipboard write allowed formats
When the Restrict session clipboard write setting is Allowed, client clipboard data cannot be shared with session applications. You can use this setting to allow specific data formats to be shared with the session clipboard.
The following clipboard formats are system defined:
- CF_TEXT
- CF_BITMAP
- CF_METAFILEPICT
- CF_SYLK
- CF_DIF
- CF_TIFF
- CF_OEMTEXT
- CF_DIB
- CF_PALETTE
- CF_PENDATA
- CF_RIFF
- CF_WAVE
- CF_UNICODETEXT
- CF_ENHMETAFILE
- CF_HDROP
- CF_LOCALE
- CF_DIBV5
- CF_OWNERDISPLAY
- CF_DSPTEXT
- CF_DSPBITMAP
- CF_DSPMETAFILEPICT
- CF_DISPENHMETAFILE
- CF_HTML
The following custom formats are predefined in XenApp and XenDesktop:
- CFX_RICHTEXT
- CFX_OfficeDrawingShape
- CFX_BIFF8
HTML format is disabled by default. To enable this feature:
- Ensure Client clipboard redirection is set to allowed.
- Ensure Restrict session clipboard write is set to enabled.
- Add an entry for CF_HTML (and any other formats you want supported) in Session clipboard write allowed formats.
Note: Enabling HTML format clipboard copy support (CF_HTML) copies any scripts (if they exist) from the source of the copied content to the destination. Check that you trust the source before proceeding to copy. If you do copy content containing scripts, they are live only if you save the destination file as an HTML file and execute it.
More custom formats can be added. The custom format name must match the formats to be registered with the system. Format names are case-sensitive.
This setting does not apply if either the Client clipboard redirection setting or Restrict session clipboard write setting is set to Prohibited.
In this article
- Adaptive transport
- Application launch wait timeout
- Client clipboard redirection
- Client clipboard write allowed formats
- Desktop launches
- ICA listener connection timeout
- ICA listener port number
- Launching of non-published programs during client connection
- Logoff checker startup delay
- Restrict client clipboard write
- Restrict session clipboard write
- Session clipboard write allowed formats