winrs
S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012
La gestion à distance de Windows avec la commande winrs vous permet de gérer et d’exécuter des programmes à distance.
Syntaxe
winrs [/<parameter>[:<value>]] <command>
Paramètres
| Paramètre | Description |
|---|---|
| /remote:<endpoint> | Spécifie le point de terminaison cible à l’aide d’un nom NetBIOS ou de la connexion standard : - <url> : [<transport>://]<target>[:<port>] par défaut, /r:localhost est utilisé. |
| /unencrypted | Spécifie que les messages vers le shell distant ne sont pas chiffrés. Ce paramètre est utile pour la résolution des problèmes ou quand le trafic réseau est déjà chiffré en utilisant ipsec, ou quand une sécurité physique est appliquée. Par défaut, les messages sont chiffrés à l’aide de clés Kerberos ou NTLM. Cette option de ligne de commande est ignorée lorsque le transport HTTPS est sélectionné. |
| /username:<username> | Spécifie le nom d’utilisateur sur la ligne de commande. S’il n’est pas spécifié, l’outil utilise l’authentification Négocier ou demande le nom. Si /username est spécifié, /password doit également être spécifié. |
| /password :<mot_de_passe> | Spécifie le mot de passe sur la ligne de commande. Si /password n’est pas spécifié, mais que /username est spécifié, l’outil vous demande le mot de passe. Si /password est spécifié, /username doit aussi être spécifié. |
| /timeout :<secondes> | Cette fonction est déconseillée. |
| /directory:<path> | Spécifie le répertoire de démarrage pour l’interpréteur de commandes distant. S’il n’est pas spécifié, le shell distant démarre dans le répertoire de base de l’utilisateur défini par la variable d’environnement %USERPROFILE%. |
| /environment:<string>=<value> | Spécifie une variable d’environnement unique à définir au démarrage de l’interpréteur de commandes, ce qui permet de modifier l’environnement par défaut pour l’interpréteur de commandes. Plusieurs occurrences de ce commutateur doivent être utilisées pour spécifier plusieurs variables d’environnement. |
| /noecho | Spécifie que l’écho doit être désactivé. noecho peut être nécessaire pour garantir que les réponses de l’utilisateur aux invites distantes ne sont pas affichées localement. Par défaut, l’écho est activé. |
| /noprofile | Spécifie que le profil de l’utilisateur ne doit pas être chargé. Par défaut, le serveur tente de charger le profil utilisateur. Si l’utilisateur distant n’est pas administrateur local sur le système cible, cette option est obligatoire (la valeur par défaut entraîne une erreur). |
| /allowdelegate | Spécifie que les informations d’identification de l’utilisateur peuvent être utilisées pour accéder à un partage distant, par exemple une machine différente du point de terminaison cible. |
| /compression | Activez la compression. Des installations plus anciennes sur des machines distantes peuvent ne pas prendre en charge la compression. La valeur par défaut est off (désactivé), car les installations plus anciennes sur des machines distantes peuvent ne pas prendre en charge la compression. |
| /usessl | Utilisez une connexion SSL lors de l’utilisation d’un point de terminaison distant. La spécification de SSL au lieu du transport https: utilise le port par défaut de WinRM. |
| /? | Affiche l'aide à l'invite de commandes. |
Notes
- Toutes les options de ligne de commande acceptent la forme courte ou longue. Par exemple, /r et /remote sont tous deux valides.
- Pour arrêter la commande /remote, l’utilisateur peut taper Ctrl+C ou Ctrl+Pause, qui est envoyé au shell distant. Un deuxième Ctrl+C force l’arrêt de winrs.exe.
- Pour gérer les interpréteurs de commandes distants actifs ou la configuration winrs, utilisez l’outil WinRM. L’alias URI pour gérer les interpréteurs de commandes actifs est shell/cmd. L’alias d’URI pour la configuration winrs est winrm/config/winrs.
Exemples
winrs /r:https://contoso.com command
winrs /r:contoso.com /usessl command
winrs /r:myserver command
winrs /r:http://127.0.0.1 command
winrs /r:http://169.51.2.101:80 /unencrypted command
winrs /r:https://[::FFFF:129.144.52.38] command
winrs /r:http://[1080:0:0:0:8:800:200C:417A]:80 command
winrs /r:https://contoso.com /t:600 /u:administrator /p:$%fgh7 ipconfig
winrs /r:myserver /env:path=^%path^%;c:\tools /env:TEMP=d:\temp config.cmd
winrs /r:myserver netdom join myserver /domain:testdomain /userd:johns /passwordd:$%fgh789
winrs /r:myserver /ad /u:administrator /p:$%fgh7 dir \\anotherserver\share