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