winrs

Si applica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Gestione remota Windows con il comando winrs consente di gestire ed eseguire programmi in remoto.

Sintassi

winrs [/<parameter>[:<value>]] <command>

Parametri

Parametro Descrizione
/remote:<endpoint> Specifica l'endpoint di destinazione usando un nome NetBIOS o la connessione standard:

- <url>: [<transport>://]<target>[:<port>]

se non specificato, viene usato /r:localhost .

/Unencrypted Specifica che i messaggi nella shell remota non sono crittografati. Questo parametro è utile per la risoluzione dei problemi o quando il traffico di rete è già crittografato tramite ipsec o quando viene applicata la sicurezza fisica.

Per impostazione predefinita, i messaggi vengono crittografati tramite chiavi Kerberos o NTLM.

Questa opzione della riga di comando viene ignorata quando è selezionato il trasporto HTTPS.

/username:<username> Specifica il nome utente nella riga di comando.

Se non specificato, lo strumento usa l'autenticazione Negotiate o richiede il nome.

Se si specifica /username , è necessario specificare anche /password .

/password:<password> Specifica la password nella riga di comando.

Se /password non è specificato ma /username è , lo strumento richiede la password.

Se si specifica /password , è necessario specificare anche /username .

/timeout:<seconds> Questa opzione è deprecata.
/directory:<path> Specifica la directory iniziale per la shell remota.

Se non specificato, la shell remota viene avviata nella home directory dell'utente definita dalla variabile di ambiente %U edizione Standard RPROFILE%.

/environment:<string>=<value> Specifica una singola variabile di ambiente da impostare all'avvio della shell, che consente di modificare l'ambiente predefinito per la shell.

Per specificare più variabili di ambiente, è necessario usare più occorrenze di questa opzione.

/noecho Specifica che echo deve essere disabilitato. noecho potrebbe essere necessario per assicurarsi che le risposte dell'utente alle richieste remote non vengano visualizzate localmente.

Per impostazione predefinita, echo è attivato.

/noprofile Specifica che il profilo dell'utente non deve essere caricato.

Per impostazione predefinita, il server tenta di caricare il profilo utente.

Se l'utente remoto non è un amministratore locale nel sistema di destinazione, questa opzione è obbligatoria (l'impostazione predefinita genera un errore).

/allowdelegate Specifica che le credenziali dell'utente possono essere usate per accedere a una condivisione remota, ad esempio un computer diverso rispetto all'endpoint di destinazione.
/Compressione Attivare la compressione. Le installazioni meno recenti nei computer remoti potrebbero non supportare la compressione.

L'impostazione predefinita è disattivata perché le installazioni precedenti nei computer remoti potrebbero non supportare la compressione.

/usessl Usare una connessione SSL quando si usa un endpoint remoto. Specificare SSL anziché il trasporto https: usa la porta predefinita winRM predefinita.
/? Visualizza la guida al prompt dei comandi.

Osservazioni:

  • Tutte le opzioni della riga di comando accettano una forma breve o una maschera lunga. Ad esempio, sia /r che /remote sono validi.
  • Per terminare il comando /remote , l'utente può digitare CTRL-C o CTRL-break, che viene inviato alla shell remota. Il secondo CTRL+C forza la terminazione di winrs.exe.
  • Per gestire le shell remote attive o la configurazione winrs, usare lo strumento WinRM. L'alias URI per gestire le shell attive è shell/cmd. L'alias URI per la configurazione winrs è winrm/config/winrs.

Esempi

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