Sélection d'une passerelle adaptative

Pris en charge sur : Toutes les plates-formes Citrix Workspace prises en charge

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)

Plus d'options disponibles

Options

Latency Threshold

AdaptiveGatewaySelection_ThresholdHighLatency decimal - plage 1-5000 - défaut : 300

Latency Breach Duration

AdaptiveGatewaySelection_ThresholdMinTime decimal - plage 0-3600 - défaut : 30

Port proxy

AdaptiveGatewaySelection_ThresholdWifiSignalStrength decimal - plage 0-100 - défaut : 30

REG Builder

BETA

Configurez l'état et les éléments pour générer les sorties .reg, PowerShell, Intune et SCCM.

Ces exports reproduisent l'effet registre de la stratégie. Modifier le registre directement n'équivaut pas à appliquer la GPO via la console (pas de gpupdate, pas de suivi centralisé). Testez avant la production ; HKLM nécessite des droits administrateur.

Non configuré Activé Désactivé

Latency Threshold

Latency Breach Duration

Port proxy

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:0000001e

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 DWord

Intune 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 DWord

SCCM CI

# 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 DWord