Tutoriel 📝 Résoudre les échecs des commandes PowerShell à distance malgré une configuration correct

[Sylvain*]

Résoudre les échecs des commandes PowerShell à distance malgré une configuration correcte

Introduction

L’utilisation de PowerShell à distance est essentielle pour administrer efficacement des systèmes Windows 10, Windows 11 ou Windows Server en environnement professionnel. Toutefois, il peut arriver que les commandes distantes échouent, même après avoir correctement configuré WinRM, les règles de pare-feu et les autorisations. Ce guide propose plusieurs approches pour identifier et corriger les erreurs empêchant l’utilisation des outils de gestion distants.

---

Prérequis

• Connaissance des commandes PowerShell Remoting

• Familiarité avec les services WinRM et les règles de pare-feu Windows Defender

• Accès administrateur sur les machines locales et distantes

---

Différentes Approches

• Approche #1 : Vérification des services et connectivité via CMD

• Approche #2 : Diagnostic complet avec PowerShell

• Approche #3 : Script .PS1 de test et réparation automatique de WinRM

---

Niveau de difficulté

• Approche #1 : Facile

• Approche #2 : Intermédiaire

• Approche #3 : Avancé

---

Les Avantages

• Approche #1 : Diagnostic rapide et basique

• Approche #2 : Analyse détaillée de la configuration distante

• Approche #3 : Automatisation complète de la résolution des erreurs

---

Les Inconvénients

• Approche #1 : Ne détecte pas les erreurs de configuration profondes

• Approche #2 : Requiert des connaissances sur WSMan

• Approche #3 : Risque de modifier des paramètres sensibles si non maîtrisé

---

Approche #1

Ouvrir CMD en tant qu’administrateur

Vérifier si le service WinRM est démarré

sc query WinRM

Lancer la configuration automatique de base

winrm quickconfig

Vérifier l’ouverture du port TCP 5985 (HTTP)

netstat -an | find "5985"

Tester la connectivité avec la machine distante

ping NomMachineDistante

---

Approche #2

Ouvrir PowerShell en tant qu’administrateur

Tester la session distante

Test-WsMan NomMachineDistante

Tenter une connexion de session

Enter-PSSession -ComputerName NomMachineDistante -Credential (Get-Credential)

Si erreur, vérifier les règles de pare-feu

Get-NetFirewallRule -DisplayGroup "Windows Remote Management"

Vérifier la stratégie d'exécution

Get-Item WSMan:\localhost\Client\TrustedHosts

Ajouter l’hôte si nécessaire :

Set-Item WSMan:\localhost\Client\TrustedHosts -Value "NomMachineDistante"

---

Approche #3

Créer un fichier FixPowerShellRemote.ps1

Insérer le script suivant :

Enable-PSRemoting -Force
Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP" -Enabled True
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "" -Force
Restart-Service WinRM

Exécuter sur chaque machine à distance avec un outil de déploiement ou manuellement

Réinitialiser les hôtes approuvés ensuite si nécessaire

Set-Item WSMan:\localhost\Client\TrustedHosts -Value ""

---

Astuce

Utilisez des noms DNS complets ou les adresses IP dans TrustedHosts pour plus de précision et de sécurité.

---

Mise en garde

Évitez l’utilisation de l’astérisque () dans TrustedHosts en environnement de production sécurisé. Préférez une liste restreinte d’hôtes.

---

Conseil

Documentez les étapes de résolution pour chaque machine afin d’éviter la répétition des tests sur des configurations similaires.

---

Solution alternative

Voici des outils tiers pour diagnostiquer et gérer la connectivité distante PowerShell :

• Paessler PRTG WinRM Monitoring

• SolarWinds Remote Execution PowerShell

• PowerShell Remoting Tool Windows Administration

---

Références

• Support Microsoft

• Microsoft Learn

• Recherche Github

---

Conclusion

L’échec d’utilisation de PowerShell à distance malgré une configuration apparemment correcte est souvent lié à un détail manquant : hôtes non approuvés, pare-feu bloquant, services non démarrés ou ports fermés. Ce guide vous permet de diagnostiquer étape par étape et de corriger efficacement la connectivité. L’utilisation de scripts automatisés permet également de standardiser les déploiements à grande échelle.