winrs

적용 대상: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

winrs 명령을 사용하여 Windows 원격 관리를 사용하면 프로그램을 원격으로 관리하고 실행할 수 있습니다.

구문

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이면 도구에서 암호를 묻는 메시지를 표시합니다.

/password를 지정하는 경우 /username도 지정해야 합니다.

/timeout:<seconds> 이 옵션은 사용되지 않습니다.
/directory:<path> 원격 셸에 대 한 시작 디렉터리를 지정합니다.

지정하지 않으면 환경 변수 %USERPROFILE%로 정의된 사용자의 홈 디렉터리에서 원격 셸이 시작됩니다.

/environment:<string>=<value> 셸 시작 되 면 기본 환경에 대 한 변경 허용 셸 설정 해야 하는 단일 환경 변수를 지정 합니다.

여러 환경 변수를 지정 하려면이 스위치를 여러 번 사용 되어야 합니다.

/noecho 해당 에코 하지 않도록 지정 합니다. 원격 프롬프트에 대한 사용자의 답변이 로컬로 표시되지 않도록 하려면 noecho가 필요할 수 있습니다.

기본적으로 에코가 켜집니다.

/noprofile 사용자의 프로필을 로드하지 않도록 지정합니다.

기본적으로 서버는 사용자 프로필을 로드하려고 시도합니다.

원격 사용자가 대상 시스템의 로컬 관리자가 아닌 경우 이 옵션이 필요합니다(기본값은 오류가 발생합니다.)

/allowdelegate 사용자의 자격 증명을 사용하여 원격 공유에 액세스할 수 있도록 지정합니다(예: 대상 엔드포인트와 다른 컴퓨터).
/압축 압축을 사용 합니다. 원격 컴퓨터의 이전 설치는 압축을 지원하지 않을 수 있습니다.

원격 컴퓨터의 이전 설치에서 압축을 지원하지 않을 수 있으므로 기본 설정이 해제됩니다.

/usessl 원격 엔드포인트를 사용 하는 경우 SSL 연결을 사용 합니다. 전송 https 대신 SSL을 지정합니다 . 기본 WinRM 기본 포트를 사용합니다.
/? 명령 프롬프트에 도움말을 표시합니다.

설명

  • 모든 명령줄 옵션 약식 표현 또는 긴 형식에 적용 합니다. 예를 들어 /r/remote는 모두 유효합니다.
  • /remote 명령을 종료하기 위해 사용자는 원격 셸로 전송되는 Ctrl-C 또는 Ctrl-break를 입력할 수 있습니다. 두 번째 Ctrl-C 는 winrs.exe를 강제로 종료합니다.
  • 활성 원격 셸 또는 winrs 구성을 관리하려면 WinRM 도구를 사용합니다. URI 활성 셸을 관리 하기 별칭은 셸/cmd합니다. winrs 구성에 대한 URI 별칭은 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