Turn On Compatibility HTTP Listener
Activer l’écouteur HTTP de compatibilité
Explanation
This policy setting turns on or turns off an HTTP listener created for backward compatibility purposes in the Windows Remote Management (WinRM) service.
If you enable this policy setting, the HTTP listener always appears.
If you disable or do not configure this policy setting, the HTTP listener never appears.
When certain port 80 listeners are migrated to WinRM 2.0, the listener port number changes to 5985.
A listener might be automatically created on port 80 to ensure backward compatibility.
Ce paramètre de stratégie active ou désactive l’écouteur HTTP créé en vue d’assurer la compatibilité descendante dans le service Gestion à distance de Windows (WinRM).
Si vous activez ce paramètre de stratégie, l’écouteur HTTP apparaît toujours.
Si vous désactivez ce paramètre de stratégie ou ne le configurez pas, l’écouteur HTTP n’apparaît jamais.
En cas de migration de certains écouteurs du port 80 vers WinRM 2.0, le numéro du port d’écoute est remplacé par le numéro 5985.
Il est possible de créer automatiquement un écouteur pour le port 80 afin d’assurer la compatibilité descendante.
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\WinRM\Service- Value name
HttpCompatibilityListener
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_DWORD = 0 |
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: WindowsRemoteManagement/HttpCompatibilityListener
$k = 'HKLM:\Software\Policies\Microsoft\Windows\WinRM\Service'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'HttpCompatibilityListener' -Value 1 -Type DWordDisable
# Disable: WindowsRemoteManagement/HttpCompatibilityListener
$k = 'HKLM:\Software\Policies\Microsoft\Windows\WinRM\Service'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'HttpCompatibilityListener' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": WindowsRemoteManagement/HttpCompatibilityListener
$k = 'HKLM:\Software\Policies\Microsoft\Windows\WinRM\Service'
Remove-ItemProperty -Path $k -Name 'HttpCompatibilityListener' -ErrorAction SilentlyContinue