winrs
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012
O Gerenciamento Remoto do Windows usando o comando winrs permite que você gerencie e execute programas remotamente.
Sintaxe
winrs [/<parameter>[:<value>]] <command>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| /remote:<ponto de extremidade> | Especifica o ponto de extremidade de destino usando um nome NetBIOS ou a conexão padrão: - <url>: [<transporte>://]<destino>[:<porta>] se não for especificado, /r:localhost será usado. |
| /unencrypted | Especifica que as mensagens para o shell remoto não são criptografadas. Esse parâmetro é útil para a solução de problemas, quando o tráfego de rede já está criptografado usando ipsec ou quando a segurança física é imposta. Por padrão, as mensagens são criptografadas usando as chaves Kerberos ou NTLM. Essa opção da linha de comando é ignorada quando o transporte HTTPS é selecionado. |
| /username:<nome de usuário> | Especifica o nome de usuário na linha de comando. Se não for especificado, a ferramenta usará a autenticação Negotiate ou solicitará o nome. Se /username for especificado, /password também deverá ser especificado. |
| /password:<password> | Especifica a senha na linha de comando. Se /password não for especificado, mas /username for, a ferramenta solicitará a senha. Se /password for especificado, /username também deverá ser especificado. |
| /timeout:<seconds> | Essa opção foi preterida. |
| /directory:<caminho> | Especifica o diretório inicial do shell remoto. Se não for especificado, o shell remoto será iniciado no diretório inicial do usuário definido pela variável de ambiente %USERPROFILE%. |
| /environment:<string>=<value> | Especifica uma única variável de ambiente a ser definida quando o shell é iniciado, o que permite alterar o ambiente padrão para o shell. Várias ocorrências dessa opção devem ser usadas para especificar diversas variáveis de ambiente. |
| /noecho | Especifica que o eco deve ser desabilitado. noecho pode ser necessário para garantir que as respostas do usuário a prompts remotos não sejam exibidas localmente. Por padrão, o eco está ativado. |
| /noprofile | Especifica que o perfil do usuário não deve ser carregado. Por padrão, o servidor tenta carregar o perfil do usuário. Se o usuário remoto não for um administrador local no sistema de destino, essa opção será necessária (o padrão resultará em erro). |
| /allowdelegate | Especifica que as credenciais do usuário podem ser usadas para acessar um compartilhamento remoto, por exemplo, uma máquina diferente do terminal de destino. |
| /compression | Habilite compactação. Instalações mais antigas em computadores remotos podem não dar suporte à compactação. A configuração padrão está desativada, pois as instalações mais antigas em computadores remotos podem não dar suporte à compactação. |
| /usessl | Use uma conexão SSL ao usar um ponto de extremidade remoto. Especificar SSL em vez do https: de transporte usará a porta padrão WinRM. |
| /? | Exibe a ajuda no prompt de comando. |
Comentários
- Todas as opções da linha de comando aceitam uma forma curta ou longa. Por exemplo, tanto /r quanto /remote são válidos.
- Para encerrar o comando /remote, o usuário pode digitar Ctrl-C ou Ctrl-break, que é enviado para o shell remoto. O segundo Ctrl-C força o encerramento de winrs.exe.
- Para gerenciar a configuração ativa dos shells remotos ou de winrs, use a ferramenta WinRM. O alias de URI para gerenciar os shells ativos é shell/cmd. O alias de URI para a configuração de winrs é winrm/config/winrs.
Exemplos
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