Manage App shortcut
Supported on: All Citrix Workspace supported platforms
Description
If you enable this policy setting: - When enabled, resources in your store are not displayed in the Windows Add or remove apps list (default is false). - When enabled, shortcuts and the Citrix Workspace icon for an application are automatically removed from the store when the application is no longer available (default is false). - Clear the set of applications shown in the Citrix Workspace Window on logoff. When selected, this option purges user details upon Citrix Workspace logoff. Deselecting this option, Citrix Workspace may not purge user details on upon Citrix Workspace logoff. - Prevent Citrix Workspace performing a refresh of the application list when opened. When selected, this option prevents Citrix Workspace from performing a refresh of the application list after launching. Deselecting this option, Citrix Workspace refreshes the application list when launching Citrix Workspace. - Ignore self service selection of apps and make all mandatory. If Citrix Workspace is working with a PNAgent service this will be required to get all apps added automatically. If Citrix Workspace is working with a StoreFront Store, make the change on the StoreFront server to make the Store mandatory. (This setting currently does not apply to StoreFront Stores). When selected, this option subscribes all applications in SelfService for PNAgent sites. Deselecting this option, the end user must manually subscribe to all the applications or required applications from the PNAgent sites.
Registry
HKLM
SOFTWARE\Policies\Citrix\Dazzle 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 App shortcut
; State: Enabled
; Supported on: All Citrix Workspace supported platforms
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\Dazzle]
"StartMenuDir"=""
"DesktopDir"=""
"PutShortcutsInstartmenu"=dword:00000000
"PutShortcutsOnDesktop"=dword:00000000
"UseCategoryAsStartMenuPath"=dword:00000000
"UseCategoryAsDesktopPath"=dword:00000000
"UseDifferentPathsforStartmenuAndDesktop"=dword:00000000
"RemoveAppsOnLogoff"=dword:00000000
"RemoveAppsOnExit"=dword:00000000
"DontCreateAddRemoveEntry"=dword:00000000
"SilentlyUninstallRemovedResources"=dword:00000000
"ClearAppListOnLogoff"=dword:00000000
"SuppressRefreshOnStartup"=dword:00000000
"AllAppsAreMandatory"=dword:00000000PowerShell
# Exported from gporais.com
# Policy: Manage App shortcut
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'StartMenuDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'DesktopDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'PutShortcutsInstartmenu' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'PutShortcutsOnDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsStartMenuPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsDesktopPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseDifferentPathsforStartmenuAndDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnExit' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'DontCreateAddRemoveEntry' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SilentlyUninstallRemovedResources' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'ClearAppListOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SuppressRefreshOnStartup' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'AllAppsAreMandatory' -Value 0 -Type DWordIntune 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 App shortcut
# 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\Dazzle' -Name 'StartMenuDir' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'DesktopDir' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'PutShortcutsInstartmenu' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'PutShortcutsOnDesktop' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseCategoryAsStartMenuPath' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseCategoryAsDesktopPath' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseDifferentPathsforStartmenuAndDesktop' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'RemoveAppsOnLogoff' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'RemoveAppsOnExit' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'DontCreateAddRemoveEntry' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'SilentlyUninstallRemovedResources' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'ClearAppListOnLogoff' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'SuppressRefreshOnStartup' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'AllAppsAreMandatory' -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: Manage App shortcut
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'StartMenuDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'DesktopDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'PutShortcutsInstartmenu' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'PutShortcutsOnDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsStartMenuPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsDesktopPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseDifferentPathsforStartmenuAndDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnExit' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'DontCreateAddRemoveEntry' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SilentlyUninstallRemovedResources' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'ClearAppListOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SuppressRefreshOnStartup' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'AllAppsAreMandatory' -Value 0 -Type DWordSCCM CI
# Exported from gporais.com
# Policy: Manage App shortcut
# 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 App shortcut
# 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\Dazzle' -Name 'StartMenuDir' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'DesktopDir' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'PutShortcutsInstartmenu' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'PutShortcutsOnDesktop' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseCategoryAsStartMenuPath' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseCategoryAsDesktopPath' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'UseDifferentPathsforStartmenuAndDesktop' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'RemoveAppsOnLogoff' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'RemoveAppsOnExit' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'DontCreateAddRemoveEntry' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'SilentlyUninstallRemovedResources' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'ClearAppListOnLogoff' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'SuppressRefreshOnStartup' -Expected 0 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle' -Name 'AllAppsAreMandatory' -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: Manage App shortcut
# State: Enabled
# Supported on: All Citrix Workspace supported platforms
$path = 'HKLM:\SOFTWARE\Policies\Citrix\Dazzle'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'StartMenuDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'DesktopDir' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'PutShortcutsInstartmenu' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'PutShortcutsOnDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsStartMenuPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseCategoryAsDesktopPath' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'UseDifferentPathsforStartmenuAndDesktop' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'RemoveAppsOnExit' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'DontCreateAddRemoveEntry' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SilentlyUninstallRemovedResources' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'ClearAppListOnLogoff' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'SuppressRefreshOnStartup' -Value 0 -Type DWord
Set-ItemProperty -Path $path -Name 'AllAppsAreMandatory' -Value 0 -Type DWord