Workspace app version
Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
Description
When enabled, Citrix pushes an automatic update to end users when the Citrix Workspace app is installed. The update can be the latest or a specific version. - Workspace App Version- To manage the version, specify the Citrix Workspace App version. - Upgrade To Latest Version- If enabled, the most recent version will be installed and above parameters will be ignored. - Preferred Start Date- The date on which Citrix Workspace can begin pushing updates. (Date format : YYYY-MM-DD). - Preferred Delivery Period- Delivery window in days. Example: Workspace App Version - 24.10.1.5 Preferred Start Date - 2024-11-27
Registry
Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6 REG Builder
BETAConfigure the state and elements to generate .reg, PowerShell, Intune, and SCCM outputs.
These exports replicate the policy's registry effect. Editing the registry directly is not the same as applying the GPO through the management console (no gpupdate, no central reporting). Test before production; HKLM changes require administrator rights.
.reg file
Windows Registry Editor Version 5.00
; Exported from gporais.com
; Policy: Workspace app version
; State: Enabled
; Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
[HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6]
"versionControl"=""
"UpgradeToLatest"=dword:00000001
"startDate"=""
"deliveryPeriod"=dword:00000000 PowerShell
# Exported from gporais.com
# Policy: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'versionControl' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'UpgradeToLatest' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'startDate' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'deliveryPeriod' -Value 0 -Type DWord Intune XML
No direct Policy CSP / OMA-URI mapping for this policy. Use the Intune Remediation tab, or ingest the ADMX in Intune. Intune Remediation
# === Detection script ===
# Exported from gporais.com
# Policy: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
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\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'versionControl' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'UpgradeToLatest' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'startDate' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'deliveryPeriod' -Expected 0 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'versionControl' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'UpgradeToLatest' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'startDate' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'deliveryPeriod' -Value 0 -Type DWord SCCM CI
# Exported from gporais.com
# Policy: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
# 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: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
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\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'versionControl' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'UpgradeToLatest' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'startDate' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6' -Name 'deliveryPeriod' -Expected 0 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Workspace app version
# State: Enabled
# Supported on: ADMX Migrator encountered a policy that does not have a supportedOn value.
$path = 'HKLM:\Software\Policies\Citrix\ICA Client\AutoUpdate\1CDF566D-B2C7-47CA-802F-6283C862E1D6'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'versionControl' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'UpgradeToLatest' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'startDate' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'deliveryPeriod' -Value 0 -Type DWord