Manage Global App Config Service
Supported on: All Citrix Workspace supported platforms
Description
The Citrix Global App Config Service for Citrix Workspace allows Citrix administrators to deliver Workspace service URLs and Citrix Workspace App settings through a centrally managed cloud service. Citrix Global App Config Service is a set of preconfigured settings you can apply to Citrix Workspace app. Using this policy, Citrix Workspace app retrieves the settings from the Citrix Global App Config Service and applies them in the environment. When you set this policy to Disabled, the settings from Citrix Global App Config Service are not retrieved and honored in Citrix Workspace app. When you set this policy to Enabled, the settings from Citrix Global App Config Service are recognized as a configuration method in Citrix Workspace app.
Registry
Software\Policies\Citrix\GlobalAppConfig This policy sets several registry values:
configManagerEnabled configManagerEnabled = 1 configManagerEnabled = 0 multiStorageConfigurationEnabled multiStorageConfigurationEnabled = 1 multiStorageConfigurationEnabled = 0 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: Manage Global App Config Service
; State: Enabled
; Supported on: All Citrix Workspace supported platforms
[HKEY_LOCAL_MACHINE\Software\Policies\Citrix\GlobalAppConfig]
"configManagerEnabled"=dword:00000001
"multiStorageConfigurationEnabled"=dword:00000001 PowerShell
# Exported from gporais.com
# Policy: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\Software\Policies\Citrix\GlobalAppConfig'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'configManagerEnabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'multiStorageConfigurationEnabled' -Value 1 -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: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
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\GlobalAppConfig' -Name 'configManagerEnabled' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\GlobalAppConfig' -Name 'multiStorageConfigurationEnabled' -Expected 1 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\Software\Policies\Citrix\GlobalAppConfig'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'configManagerEnabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'multiStorageConfigurationEnabled' -Value 1 -Type DWord SCCM CI
# Exported from gporais.com
# Policy: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
# 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: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
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\GlobalAppConfig' -Name 'configManagerEnabled' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Citrix\GlobalAppConfig' -Name 'multiStorageConfigurationEnabled' -Expected 1 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Manage Global App Config Service
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\Software\Policies\Citrix\GlobalAppConfig'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'configManagerEnabled' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'multiStorageConfigurationEnabled' -Value 1 -Type DWord