Administrer un serveur Windows avec PowerShell Remoting en HTTPS
Configurez PowerShell Remoting via HTTPS sur Windows Server : certificat, écouteur WinRM sur le port 5986, pare-feu limité à votre adresse IP et connexion sécurisée.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
PowerShell Remoting permet d'exécuter des commandes sur votre serveur depuis votre poste, sans ouvrir de session graphique. Ce guide met en place un accès chiffré en HTTPS sur le port 5986, avec un certificat vérifié par le client et un pare-feu qui n'accepte que votre adresse IP.
Fonctionnement
PowerShell Remoting repose sur le service WinRM, activé par défaut sur Windows Server.
| Port | Transport | Usage dans ce guide |
|---|---|---|
5985 |
HTTP | Reste disponible localement, mais fermé depuis le réseau |
5986 |
HTTPS | Seul accès distant, limité à votre adresse IP |
Depuis un poste hors domaine, l'authentification passe par NTLM, qui ne prouve pas l'identité du serveur. Le certificat HTTPS comble ce manque : votre poste vérifie qu'il parle bien à votre serveur avant d'envoyer quoi que ce soit.
Prérequis
- Un serveur sous Windows Server 2019, 2022 ou 2025, accessible en RDP avec un compte administrateur.
- Un poste d'administration sous Windows, avec des droits d'administrateur. Le transport WinRM n'est pas pris en charge par PowerShell sous Linux et macOS.
- L'adresse IP publique de ce poste, de préférence fixe.
- Un nom d'hôte pour le serveur, par exemple
srv.votre-domaine.com.
Choisir le nom d'hôte
Le nom utilisé à la connexion doit être identique à celui du certificat. Deux possibilités :
- Avec un domaine : créez un enregistrement DNS de type
Apointantsrv.votre-domaine.comvers l'adresse de votre serveur. - Sans enregistrement DNS : choisissez un nom et déclarez-le dans le fichier
hostsde votre poste, comme indiqué à l'étape 6.
1. Vérifier WinRM sur le serveur
Ouvrez PowerShell en tant qu'administrateur sur le serveur :
Get-Service WinRM | Format-Table Name, Status, StartType
Test-WSManLe service doit être à l'état Running et Test-WSMan doit renvoyer des informations sur le protocole. Si ce n'est pas le cas, réactivez le service :
Enable-PSRemoting -Force2. Créer le certificat
Option A : certificat auto-signé
Cette option convient bien à un administrateur unique, car vous installez vous-même le certificat sur votre poste. Il est valable deux ans ici, et sa clé privée n'est pas exportable.
$hostName = 'srv.votre-domaine.com'
$cert = New-SelfSignedCertificate -DnsName $hostName -CertStoreLocation 'Cert:\LocalMachine\My' -KeyExportPolicy NonExportable -NotAfter (Get-Date).AddYears(2)
$cert | Format-List Subject, Thumbprint, NotAfter
New-Item -ItemType Directory -Path 'C:\WinRM' -Force | Out-Null
Export-Certificate -Cert $cert -FilePath 'C:\WinRM\winrm-https.cer'Le fichier .cer ne contient que la partie publique du certificat. Notez l'empreinte (Thumbprint) : vous la comparerez sur votre poste.
Option B : certificat d'une autorité reconnue
Si vous disposez déjà d'un certificat pour ce nom au format PFX, importez-le. Son champ CN doit correspondre au nom d'hôte et il doit autoriser l'authentification serveur.
$pfxPassword = Read-Host 'PFX password' -AsSecureString
Import-PfxCertificate -FilePath 'C:\WinRM\certificate.pfx' -CertStoreLocation 'Cert:\LocalMachine\My' -Password $pfxPasswordSupprimez ensuite le fichier PFX du serveur. Avec cette option, vous n'avez pas besoin d'importer le certificat sur votre poste.
3. Créer l'écouteur HTTPS
$hostName = 'srv.votre-domaine.com'
$cert = Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Subject -like "CN=$hostName*" } |
Sort-Object NotAfter | Select-Object -Last 1
New-WSManInstance -ResourceURI winrm/config/Listener `
-SelectorSet @{ Address = '*'; Transport = 'HTTPS' } `
-ValueSet @{ Hostname = $hostName; CertificateThumbprint = $cert.Thumbprint }Contrôlez le résultat :
Get-WSManInstance -ResourceURI winrm/config/Listener -Enumerate |
Format-Table Transport, Port, Hostname, Enabled, CertificateThumbprint
Get-NetTCPConnection -LocalPort 5986 -State ListenN'utilisez pas winrm quickconfig -transport:https avec un certificat auto-signé : cette commande le refuse.
4. Ouvrir le port 5986 pour votre seule adresse IP
Depuis votre session RDP, cette commande affiche l'adresse publique vue par le serveur (adaptez 3389 si vous utilisez un autre port RDP) :
(Get-NetTCPConnection -LocalPort 3389 -State Established).RemoteAddressSi cette adresse est bien celle de votre poste d'administration, créez la règle :
New-NetFirewallRule -Name 'WinRM-HTTPS-Admin' -DisplayName 'WinRM HTTPS - admin workstation' `
-Direction Inbound -Action Allow -Protocol TCP -LocalPort 5986 -RemoteAddress VOTRE_IP -Profile AnyAvec l'interface graphique
- Créez une règle de trafic entrant pour le port TCP
5986, comme expliqué dans le guide du pare-feu Windows, avec l'action Autoriser la connexion (Allow the connection) et tous les profils. - Ouvrez les Propriétés de la règle, puis l'onglet Étendue (Scope).
- Sous Adresses IP distantes (Remote IP address), choisissez Ces adresses IP (These IP addresses), puis ajoutez votre adresse.
Si votre offre propose un pare-feu configurable depuis la console, autorisez-y aussi ce port pour votre adresse.
5. Fermer l'accès distant en HTTP
Windows autorise par défaut le port 5985 sur le réseau local, et une adresse publique peut partager son sous-réseau avec d'autres serveurs. Désactivez ces règles. L'écouteur HTTP reste en place pour les outils locaux.
Get-NetFirewallRule -Name 'WINRM-HTTP-In-TCP*' | Disable-NetFirewallRule
Get-NetFirewallRule -Name 'WINRM-HTTP-In-TCP*' | Format-Table Name, Enabled, ProfileSi vous relancez Enable-PSRemoting plus tard, ces règles seront réactivées : refaites alors cette étape.
6. Préparer le poste d'administration
Ouvrez PowerShell en tant qu'administrateur sur votre poste.
Si le nom n'existe pas dans le DNS public, déclarez-le :
Add-Content -Path "$env:SystemRoot\System32\drivers\etc\hosts" -Value 'VOTRE_IP_SERVEUR srv.votre-domaine.com'Avec un certificat auto-signé, copiez C:\WinRM\winrm-https.cer sur votre poste, par exemple par copier-coller dans la session RDP, puis importez-le depuis le dossier où il se trouve :
Import-Certificate -FilePath '.\winrm-https.cer' -CertStoreLocation 'Cert:\LocalMachine\Root'7. Se connecter
Le nom du compte s'écrit NOM_DU_SERVEUR\VOTRE_USER. La commande hostname donne le nom du serveur. Sur un contrôleur de domaine, utilisez DOMAINE\VOTRE_USER.
$cred = Get-Credential -UserName 'NOM_DU_SERVEUR\VOTRE_USER' -Message 'Server administrator account'
Enter-PSSession -ComputerName srv.votre-domaine.com -UseSSL -Credential $credL'invite affiche alors le nom du serveur. Testez, puis quittez :
hostname
whoami
Exit-PSSessionPour lancer une commande sans session interactive, ou réutiliser une connexion et copier un fichier :
Invoke-Command -ComputerName srv.votre-domaine.com -UseSSL -Credential $cred -ScriptBlock { Get-Service WinRM }
$session = New-PSSession -ComputerName srv.votre-domaine.com -UseSSL -Credential $cred
Copy-Item -Path '.\script.ps1' -Destination 'C:\WinRM\' -ToSession $session
Remove-PSSession $sessionVérifier la configuration
Sur le serveur, contrôlez la règle de pare-feu et l'absence de transport non chiffré. Les deux derniers paramètres doivent valoir false :
Get-NetFirewallRule -Name 'WinRM-HTTPS-Admin' | Get-NetFirewallAddressFilter | Format-Table RemoteAddress
Get-NetFirewallPortFilter -Protocol TCP |
Where-Object { $_.LocalPort -contains '5986' } |
Get-NetFirewallRule | Format-Table Name, Enabled, Action, Profile
Get-Item WSMan:\localhost\Service\AllowUnencrypted
Get-Item WSMan:\localhost\Service\Auth\BasicUne seule règle active doit autoriser le port 5986. Sur votre poste, le port HTTPS doit répondre et le port HTTP non :
Test-NetConnection srv.votre-domaine.com -Port 5986 -WarningAction SilentlyContinue | Select-Object TcpTestSucceeded
Test-NetConnection srv.votre-domaine.com -Port 5985 -WarningAction SilentlyContinue | Select-Object TcpTestSucceeded
Test-WSMan -ComputerName srv.votre-domaine.com -UseSSLLe premier test doit afficher True, le second False. Pour finir, depuis une autre connexion Internet, par exemple un partage de connexion mobile, le port 5986 doit aussi afficher False.
Mettre à jour la configuration
Votre adresse IP a changé
Connectez-vous en RDP sur le serveur et remplacez l'adresse autorisée :
Set-NetFirewallRule -Name 'WinRM-HTTPS-Admin' -RemoteAddress VOTRE_IPRenouveler le certificat
Avant l'expiration, créez un nouveau certificat comme à l'étape 2, puis associez-le à l'écouteur :
$hostName = 'srv.votre-domaine.com'
$cert = Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Subject -like "CN=$hostName*" } |
Sort-Object NotAfter | Select-Object -Last 1
Set-WSManInstance -ResourceURI winrm/config/Listener `
-SelectorSet @{ Address = '*'; Transport = 'HTTPS' } `
-ValueSet @{ CertificateThumbprint = $cert.Thumbprint }Importez ensuite le nouveau fichier .cer sur votre poste, testez la connexion, puis supprimez l'ancien certificat des deux côtés.
Tout retirer
Remove-WSManInstance -ResourceURI winrm/config/Listener -SelectorSet @{ Address = '*'; Transport = 'HTTPS' }
Remove-NetFirewallRule -Name 'WinRM-HTTPS-Admin'Dépannage
Le port ne répond pas
WinRM cannot complete the operation. Verify that the specified computer name is valid, that the computer is accessible over the network, and that a firewall exception for the WinRM service is enabled.Vérifiez dans cet ordre :
- Votre adresse publique actuelle est bien celle de la règle
WinRM-HTTPS-Admin. - L'écouteur existe et le port
5986est à l'écoute sur le serveur. - Le nom d'hôte pointe vers la bonne adresse :
Resolve-DnsName srv.votre-domaine.com. - Le pare-feu configurable depuis la console de votre offre, si vous en utilisez un, autorise ce port.
Autorité de certification inconnue
The SSL certificate is signed by an unknown certificate authority.Le certificat n'est pas approuvé par votre poste. Importez le fichier .cer dans Cert:\LocalMachine\Root depuis un PowerShell administrateur, et vérifiez qu'il s'agit bien du certificat utilisé par l'écouteur.
Le nom ne correspond pas au certificat
The SSL certificate contains a common name (CN) that does not match the hostname.Connectez-vous avec le nom exact du certificat, et non avec l'adresse IP ou un autre alias.
Certificat expiré ou révocation impossible à vérifier
The SSL certificate is expired.
The SSL certificate could not be checked for revocation.Renouvelez le certificat expiré. Pour le second message, assurez-vous que votre poste peut joindre les serveurs de révocation de l'autorité.
Le client demande HTTPS ou TrustedHosts
The WinRM client cannot process the request. If the authentication scheme is different from Kerberos, or if the client computer is not joined to a domain, then HTTPS transport must be used or the destination machine must be added to the TrustedHosts configuration setting.Le paramètre -UseSSL manque dans votre commande. N'ajoutez pas le serveur à TrustedHosts : cela ne ferait que masquer l'absence de vérification de son identité.
Accès refusé
Access is denied.Contrôlez le nom du serveur, le compte et le mot de passe. Par défaut, seuls les membres du groupe Administrateurs peuvent se connecter.
Un compte local administrateur autre que le compte intégré peut aussi être refusé à cause des restrictions distantes de l'UAC. Utilisez de préférence le compte Administrateur intégré ou un compte de domaine. La valeur de registre LocalAccountTokenFilterPolicy lève cette restriction, mais pour tous les comptes locaux de la machine : ne l'activez qu'en connaissance de cause.
La création de l'écouteur échoue
Cannot create a WinRM listener on HTTPS because this machine does not have an appropriate certificate.Ce message apparaît notamment avec winrm quickconfig -transport:https : utilisez New-WSManInstance comme à l'étape 3. Vérifiez aussi que le certificat n'a pas expiré et que son CN correspond exactement à Hostname.
Si un écouteur HTTPS existe déjà, supprimez-le avec Remove-WSManInstance, puis recréez-le.
Accès refusé vers une autre machine depuis la session
Votre mot de passe n'est pas transmis au serveur distant, qui ne peut donc pas s'authentifier à votre place sur un partage réseau ou un autre serveur. C'est le problème dit du « second saut ». Exécutez la commande directement sur la machine cible, ou passez des identifiants explicites à la commande concernée.