Policy
Point of Presence Survey
Citrix Workspace
Policy overview
Key metadata and intent for this policy.
Point of Presence Survey is used when connected via a cloud gateway. When Enabled, Citrix Workspace app will perform a PoP survey to determine the optimal PoP to connect to. If latency increases above High Latency Threshold and does not improve below Low Latency Threshold within Minimum Time to Confirm Latency, a PoP survey is performed. After a PoP survey, a Cool-off Period is applied before another PoP survey can be performed. When Disabled, Citrix Workspace app will not perform PoP surveys. Low Latency Threshold: Specifies the latency threshold (in milliseconds) below which a connection is considered low latency (good state). High Latency Threshold: Specifies the latency threshold (in milliseconds) above which a connection is considered high latency (bad state). Minimum Time to Confirm Latency: Specifies the minimum time (in seconds) that high latency conditions must persist before a PoP survey is performed. Cool-off Period: Specifies the time (in seconds) to wait after a PoP survey before another PoP survey can be performed. Cloud Gateway Whitelist: A newline-delimited list of regular expressions that match cloud gateway FQDNs for which PoP survey should be performed. If the list is empty, a default set of cloud gateway FQDNs is considered. Default/example expression: ^global\.g\.nssvc\.net$ ^global-all\.g\.nssvc\.net$ Wi-Fi Signal Strength Threshold: Specifies a threshold (in percentage) below which high latency conditions are presumed to be due to poor Wi-Fi signal strength, and a PoP survey is not performed.
Registry values
How enabled and disabled states update the registry.
| Scope | Registry location | Type | Enabled value | Disabled value | Copy |
|---|---|---|---|---|---|
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_CooloffPeriod | REG_DWORD | HKLM 1800 | HKLM — | |
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_Enabled | REG_DWORD | HKLM 1 | HKLM 0 | |
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdHighLatency | REG_DWORD | HKLM 400 | HKLM — | |
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdLowLatency | REG_DWORD | HKLM 150 | HKLM — | |
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdMinTime | REG_DWORD | HKLM 30 | HKLM — | |
| Computer | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdWifiSignalStrength | REG_DWORD | HKLM 30 | HKLM — |
Policy elements
Inputs and configuration options exposed by this policy.
| Scope | Element | Type | Registry mapping | Constraints & behavior | Copy |
|---|---|---|---|---|---|
| Computer | Cloud Gateway Whitelist ID PoPSurvey_CloudGatewayWhitelist | list | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_CloudGatewayWhitelist Type REG_MULTI_SZ | None | |
| Computer | Low Latency Threshold ID PoPSurvey_ThresholdLowLatency | decimal | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdLowLatency Type REG_DWORD | Range: 1 to 5000 | |
| Computer | High Latency Threshold ID PoPSurvey_ThresholdHighLatency | decimal | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdHighLatency Type REG_DWORD | Range: 1 to 5000 | |
| Computer | Minimum Time to Confirm Latency ID PoPSurvey_ThresholdMinTime | decimal | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdMinTime Type REG_DWORD | Range: 0 to 3600 | |
| Computer | Cool-off Period ID PoPSurvey_CooloffPeriod | decimal | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_CooloffPeriod Type REG_DWORD | Range: 0 to 100000 | |
| Computer | Wi-Fi Signal Strength Threshold ID PoPSurvey_ThresholdWifiSignalStrength | decimal | Path Software\Policies\Citrix\ICA Client\Engine Value name PoPSurvey_ThresholdWifiSignalStrength Type REG_DWORD | Range: 0 to 100 |