Sélection d'une passerelle adaptative
Vérifié avec Citrix Workspace App 26.3.10 — mis à jour le 12 juillet 2026
Pris en charge sur : Toutes les plates-formes Citrix Workspace prises en charge
Chemin dans la console GPO
Configuration ordinateur\Modèles d'administration\Composants Citrix\Citrix Workspace\Routage réseau Description
La sélection d'une passerelle adaptative permet à l'application Citrix Workspace de détecter le meilleur point de présence (PoP) du service Citrix Gateway et de s'y connecter automatiquement en fonction des conditions de connexion actuelles. En cas de dépassement du seuil de latence (exprimé en millisecondes) au-delà du délai de violation de latence (exprimé en secondes), l'application sélectionne une nouvelle passerelle. Le seuil de puissance du signal Wi-Fi (exprimé en pourcentage) définit la puissance de signal minimale nécessaire à la sélection d'une passerelle. Si la puissance du signal est inférieure à ce seuil, la sélection d'une passerelle ne se produit pas.
Registre
HKLM
Software\Policies\Citrix\ICA Client\Engine Nom de valeur : AdaptiveGatewaySelection_Enabled
Activé : AdaptiveGatewaySelection_Enabled = 1
Désactivé : AdaptiveGatewaySelection_Enabled = 0
Cette stratégie définit plusieurs valeurs de registre :
AdaptiveGatewaySelection_ThresholdHighLatency Activé :
AdaptiveGatewaySelection_ThresholdHighLatency = 300 Désactivé :
AdaptiveGatewaySelection_ThresholdHighLatency = (supprimée) AdaptiveGatewaySelection_ThresholdMinTime Activé :
AdaptiveGatewaySelection_ThresholdMinTime = 30 Désactivé :
AdaptiveGatewaySelection_ThresholdMinTime = (supprimée) AdaptiveGatewaySelection_ThresholdWifiSignalStrength Activé :
AdaptiveGatewaySelection_ThresholdWifiSignalStrength = 30 Désactivé :
AdaptiveGatewaySelection_ThresholdWifiSignalStrength = (supprimée) Générateur d'exports
BETAConfigurez l'état, la portée et les options, puis générez les sorties .reg, PowerShell, Intune et SCCM — ou ajoutez le paramètre à une collection multi-paramètres.
Ces exports écrivent le registre — ce n'est pas une GPO managée. ⓘ
Fichier .reg
Windows Registry Editor Version 5.00
; Exported from gporais.com
; Policy: Sélection d'une passerelle adaptative
; State: Enabled
; Supported on: Toutes les plates-formes Citrix Workspace prises en charge
[HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine]
"AdaptiveGatewaySelection_Enabled"=dword:00000001
"AdaptiveGatewaySelection_ThresholdHighLatency"=dword:0000012c
"AdaptiveGatewaySelection_ThresholdMinTime"=dword:0000001e
"AdaptiveGatewaySelection_ThresholdWifiSignalStrength"=dword:0000001e
"AdaptiveGatewaySelection_ThresholdHighLatency"=dword:0000012c
"AdaptiveGatewaySelection_ThresholdMinTime"=dword:0000001e
"AdaptiveGatewaySelection_ThresholdWifiSignalStrength"=dword:0000001eAutres formats (PowerShell, Intune, SCCM)
PowerShell
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_Enabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWordIntune XML
Aucune correspondance directe Policy CSP / OMA-URI pour cette stratégie. Utilisez l'onglet Intune Remediation, ou importez l'ADMX dans Intune.Intune Remediation
# === Detection script ===
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_Enabled' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Expected 300 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Expected 300 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Expected 30 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_Enabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWordScripts SCCM
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
# SCCM Configuration Item guidance:
# Create a Configuration Item of type "Setting: Script".
# Discovery script: use the Detection script below.
# Remediation script: use the Remediation script below.
# Compliance rule: the Discovery script output equals 'Compliant'.
# === Detection script ===
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_Enabled' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Expected 300 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Expected 300 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Expected 30 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\Engine' -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Expected 30 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Sélection d'une passerelle adaptative
# State: Enabled
# Supported on: Toutes les plates-formes Citrix Workspace prises en charge
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_Enabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdHighLatency' -Value 300 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdMinTime' -Value 30 -Type DWord
Set-ItemProperty -Path $path -Name 'AdaptiveGatewaySelection_ThresholdWifiSignalStrength' -Value 30 -Type DWordVous construisez une collection multi-paramètres ? Ajoutez ce paramètre et générez des exports combinés (.reg, PowerShell, GPO).