Customize warning messages
Verified with Windows 11 25H2 — updated on July 30, 2026
Supported on: At least Windows Vista
Path in the GPO console
Computer Configuration\Administrative Templates\System\Remote Assistance Description
This policy setting lets you customize warning messages. The "Display warning message before sharing control" policy setting allows you to specify a custom message to display before a user shares control of his or her computer. The "Display warning message before connecting" policy setting allows you to specify a custom message to display before a user allows a connection to his or her computer. If you enable this policy setting, the warning message you specify overrides the default message that is seen by the novice. If you disable this policy setting, the user sees the default warning message. If you do not configure this policy setting, the user sees the default warning message.
Registry
HKLM
Software\policies\Microsoft\Windows NT\Terminal Services Value name: UseCustomMessages
Enabled: UseCustomMessages = 1
Disabled: UseCustomMessages = 0
MDM / Intune (CSP)
./Device/Vendor/MSFT/Policy/Config/RemoteAssistance/CustomizeWarningMessages Microsoft Learn documentation Mapping data: Microsoft Learn (CC BY 4.0)
Export Builder
BETAConfigure the state, scope and options, then generate .reg, PowerShell, Intune and SCCM outputs — or add the setting to a multi-setting collection.
These exports write the registry — this is not a managed GPO. ⓘ
.reg file
Windows Registry Editor Version 5.00
; Exported from gporais.com
; Policy: Customize warning messages
; State: Enabled
; Supported on: At least Windows Vista
[HKEY_LOCAL_MACHINE\Software\policies\Microsoft\Windows NT\Terminal Services]
"UseCustomMessages"=dword:00000001
"ShareControlMessage"=""
"ViewMessage"=""More formats (PowerShell, Intune, SCCM)
PowerShell
# Exported from gporais.com
# Policy: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
$path = 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'UseCustomMessages' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'ShareControlMessage' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'ViewMessage' -Value '' -Type StringIntune XML
OMA-URI: ./Device/Vendor/MSFT/Policy/Config/RemoteAssistance/CustomizeWarningMessages
Data type: String
Value:
<enabled/>
<data id="RA_Options_Share_Control_Message" value=""/>
<data id="RA_Options_Connect_Message" value=""/>Intune Remediation
# === Detection script ===
# Exported from gporais.com
# Policy: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
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\Microsoft\Windows NT\Terminal Services' -Name 'UseCustomMessages' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services' -Name 'ShareControlMessage' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services' -Name 'ViewMessage' -Expected '' -Kind String)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
$path = 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'UseCustomMessages' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'ShareControlMessage' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'ViewMessage' -Value '' -Type StringSCCM scripts
# Exported from gporais.com
# Policy: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
# 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: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
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\Microsoft\Windows NT\Terminal Services' -Name 'UseCustomMessages' -Expected 1 -Kind DWord)
(Test-RegistryValue -Path 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services' -Name 'ShareControlMessage' -Expected '' -Kind String)
(Test-RegistryValue -Path 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services' -Name 'ViewMessage' -Expected '' -Kind String)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Customize warning messages
# State: Enabled
# Supported on: At least Windows Vista
$path = 'HKLM:\Software\policies\Microsoft\Windows NT\Terminal Services'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'UseCustomMessages' -Value 1 -Type DWord
Set-ItemProperty -Path $path -Name 'ShareControlMessage' -Value '' -Type String
Set-ItemProperty -Path $path -Name 'ViewMessage' -Value '' -Type StringBuilding a multi-setting collection? Add this setting and generate combined .reg / PowerShell / GPO scripts.