winrs

Область применения: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Удаленное управление Windows с помощью команды winrs позволяет удаленно управлять программами и выполнять их.

Синтаксис

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

Параметры

Параметр Описание
/remote:<endpoint> Указывает целевую конечную точку с помощью имени NetBIOS или стандартного подключения:

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

Если параметр не указан, используется /r:localhost .

/Незашифрованные Указывает, что сообщения в удаленной оболочке не шифруются. Этот параметр полезен для устранения неполадок или при шифровании сетевого трафика с помощью ipsec или при принудительном применении физической безопасности.

По умолчанию сообщения шифруются с помощью ключей Kerberos или NTLM.

Этот параметр командной строки игнорируется при выборе транспорта HTTPS.

/username:<username> Указывает имя пользователя в командной строке.

Если это не указано, средство использует проверку подлинности "Согласование" или запрос имени.

Если указан параметр /username , необходимо также указать /password .

/password:<password> Указывает пароль в командной строке.

Если параметр /password не указан, но /username is, средство запрашивает пароль.

Если задан параметр /password , необходимо также указать имя пользователя .

/timeout:<seconds> Этот параметр является устаревшим.
/directory:<path> Указывает начальный каталог для удаленной оболочки.

Если это не указано, удаленная оболочка запускается в домашнем каталоге пользователя, определяемом переменной среды %USERPROFILE%.

/environment:<string>=<value> Указывает одну переменную среды, которую необходимо задать при запуске оболочки, которая позволяет изменять среду по умолчанию для оболочки.

Для указания нескольких переменных среды необходимо использовать несколько вхождений этого коммутатора.

/noecho Указывает, что необходимо отключить эхо. noecho может потребоваться, чтобы гарантировать, что ответы пользователя на удаленные запросы не отображаются локально.

По умолчанию эхо включен.

/noprofile Указывает, что профиль пользователя не должен быть загружен.

По умолчанию сервер пытается загрузить профиль пользователя.

Если удаленный пользователь не является локальным администратором в целевой системе, этот параметр необходим (значение по умолчанию приводит к ошибке).

/allowdelegate Указывает, что учетные данные пользователя можно использовать для доступа к удаленной общей папке, например компьютера, отличного от целевой конечной точки.
/Сжатия Включите сжатие. Старые установки на удаленных компьютерах могут не поддерживать сжатие.

Параметр по умолчанию отключен, так как старые установки на удаленных компьютерах могут не поддерживать сжатие.

/usessl При использовании удаленной конечной точки используйте SSL-подключение. Указание SSL вместо https транспорта: использует порт WinRM по умолчанию.
/? Отображение справки в командной строке.

Замечания

  • Все параметры командной строки принимают короткую форму или длинную форму. Например, допустимы как /r, так и /remote.
  • Чтобы завершить команду /remote , пользователь может ввести ctrl-C или CTRL-break, которая отправляется в удаленную оболочку. Второй ctrl-C заставляет завершение winrs.exe.
  • Чтобы управлять активными удаленными оболочками или конфигурацией winrs, используйте средство WinRM. Псевдоним URI для управления активными оболочками — оболочка или cmd. Псевдоним URI для конфигурации winrs — winrm/config/winrs.

Примеры

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