> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XBOX PC Remote (wdRemote.exe) > XBOX PC Remote (wdRemote.exe) XBOX PC Toolbox 앱은 미리 보기 상태입니다. Windows의 [Microsoft Store](https://aka.ms/toolboxinstaller)에서 다운로드하세요. XBOX PC Remote (wdRemote.exe)는 원격 Windows 디바이스에서 게임을 빌드하는 데 필요한 두 가지 워크플로를 가능하게 하는 명령줄 도구입니다. 다음 두 명령을 사용하여 아래 작업을 수행합니다. * PIN 페어링을 사용하여 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다. * 원격 Windows 디바이스에서 게임을 배포, 실행, 종료합니다. `wdRemote`는 개발 PC에서 실행되며, 원격 디바이스에서 실행 중인 [wdEndpoint.exe](/tools/tools-pc/commandlinetools/gr-wdEndpoint) 인스턴스와 통신합니다. Windows 디바이스용 원격 개발 도구 모음에서 `wdRemote`와 `wdEndpoint`가 수행하는 역할에 대한 설명은 [XBOX PC Remote 도구 개요](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-win-gamedev)를 참조하세요. 개발 PC에 `wdRemote`를 설치하려면 [XBOX PC Toolbox](/tools/tools-pc/xboxpctoolbox/xboxpctoolbox) 또는 WinGet을 사용하세요. `winget install Microsoft.Gaming.RemoteIterationClient` 다음 표에 나열된 명령을 실행하려면 `wdRemote`를 사용하세요. | 명령 | 설명 | | ------------------------------------------------- | ---------------------------------------------------- | | [wdRemote /action:pair](#wdRemote_pair) | PIN 페어링을 통해 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다. | | [wdRemote /action:purgekeys](#wdRemote_purgekeys) | 개발 PC에서 모든 암호화 키와 디바이스 페어링을 제거합니다. | | [wdRemote /action:version](#wdRemote_version) | wdRemote.exe의 버전을 표시합니다. | | [wdRemote /action:status](#wdRemote_status) | 개발 PC와 대상 디바이스 간 연결 상태를 표시합니다. | | [wdRemote /action:deploy](#wdRemote_deploy) | 개발 PC에서 원격 Windows 디바이스로 게임을 배포합니다. | | [wdRemote /action:launch](#wdRemote_launch) | 원격 Windows 디바이스에서 게임을 실행합니다. | | [wdRemote /action:resume](#wdRemote_resume) | 일시 중단된 상태로 실행된 원격 Windows 디바이스의 게임을 재개합니다. | | [wdRemote /action:terminate](#wdRemote_terminate) | 원격 Windows 디바이스에서 실행 중인 게임을 종료합니다. | ## 원격 Windows 디바이스 페어링 및 보안 키 관리 ### wdRemote /action:pair 이 명령은 PIN 페어링을 통해 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다. 원격 디바이스에서 실행 중인 [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint)가 PIN을 생성합니다. `wdRemote /action:pair /device:HostName | IP Address /pin:pin number` *\[/sshKey:filename]* | 옵션 | 설명 | | ------------ | ---------------------------------------------------------------------------------------------- | | /action:pair | wdRemote가 PIN 페어링 작업을 수행하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | | /pin: | 원격 디바이스에서 실행 중인 [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) 인스턴스가 생성한 PIN입니다. | | /sshKey: | 원격 디바이스에 설치할 선택적 ssh 키입니다. 이 키는 개발 PC와 원격 디바이스 간 ssh 연결을 설정하는 데 사용할 수 있습니다. | 예제: ``` // 원격 디바이스에서 `wdEndpoint /pair`를 사용하여 PIN을 얻어 페어링 과정을 시작합니다. `wdEndpoint /pair`는 관리자 권한의 명령 프롬프트에서 실행해야 합니다. c:>wdEndpoint /pair wdEndpoint version: 1.0.0.0 No configuration found at 'C:\ProgramData\Microsoft GDK\wdEndpoint\wdEndpoint.json', using defaults. Overriding security mode for pairing. Device ID: 29aab0e953b95099388b169861940a7501c7c7be Security Mode: Private Common Roots: (Default) C:\ProgramData\Microsoft GDK\gameroot Server startup. Listening for requests on: https://+:4275/gamingTransport/. Entered exclusive pairing mode for 120 seconds. PIN: q87p7w // 데스크톱 PC의 wdRemote에서 pairing /action에 결과 PIN을 지정합니다. c:>wdRemote /action:pair /device:myROGAllyX /pin:q87p7w Successfully paired. Client: a701ed911d794154737a1ed2cfe29e292d532561 Device: 231d6063b48cfc136f8ebdcad0a472edc7a27527 ``` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:purgekeys `wdRemote`와 [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) 간의 모든 트래픽은 암호화됩니다. `wdRemote`는 원격 디바이스에 처음 연결을 요청받을 때 필요한 암호화 키와 인증서를 자동으로 생성합니다. 이러한 키는 페어링 과정에서도 사용됩니다. `wdRemote /action:purgekeys`는 개발 PC에서 모든 키와 디바이스 페어링을 제거합니다. `wdRemote /action:purgekeys` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## 상태 및 버전 정보 ### wdRemote /action:version wdRemote.exe의 버전을 표시합니다. `wdRemote /action:version` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:status 개발 PC와 대상 디바이스 간의 연결 상태를 표시합니다. `wdRemote /action:pair`는 모든 디바이스 페어링을 확인하고 암호화가 적용되고 있는지 검사합니다. `wdRemote /action:status /device:HostName | IP Address` | 옵션 | 설명 | | -------------- | ----------------------------------------------------------------- | | /action:status | `wdRemote`가 개발 PC와 `/device:` 인수로 지정된 디바이스 간의 연결 상태를 표시하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## 애플리케이션 배포, 실행, 종료 ### wdRemote /action:deploy `/device:` 인수로 지정된 대상 디바이스로 개발 PC에서 게임을 배포합니다. 모든 배포는 증분식이며, 이는 마지막 배포 이후 변경된 파일만 대상 디바이스로 전송된다는 의미입니다. 게임은 대상 디바이스에서 *Common Root*라는 디렉터리에 저장됩니다. 기본적으로 Common Root는 `%ProgramData%\Microsoft GDK\gameroot`입니다. `wdRemote`에 전달되는 대상 경로는 절대 경로를 지정하지 않는 한 Common Root 기준의 상대 경로이며, 절대 경로를 지정하면 Common Root는 무시됩니다. 기본 Common Root의 위치는 변경할 수 있으며, `wdEndpoint.json`이라는 파일을 만들어 대상 디바이스의 `%ProgramData%\Microsoft GDK\wdEndpoint\`에 배치함으로써 Common Root를 더 추가할 수 있습니다. `wdEndpoint.json`은 다음 형식의 Common Root 목록을 포함합니다. ```json theme={null} { root:, alias:, default:true|false } ``` *default* 지정은 선택 사항입니다. 여러 기본값이 지정된 경우 목록의 첫 번째 항목이 기본값이 됩니다. 어떤 루트도 기본값으로 표시되지 않은 경우 첫 번째 항목이 기본값이 됩니다. 다음 예제 `wdEndpoint.json`은 두 개의 Common Root를 정의하며, 기본 루트는 `c:\developmentbuilds`이고 다른 루트는 `d:\releasedbuilds`입니다. ```json theme={null} { "gameRoots": [ { "root": "c:\\developmentbuilds", "alias": "primary", "default": true }, { "root": "d:\\releasedbuilds", "alias": "released" } ] } ``` `wdRemote /action:deploy /device:HostName | IP Address /source:directory /destination:folder under gameRoot [/root:gameRoot alias]` | 옵션 | 설명 | | -------------- | ------------------------------------------------------ | | /action:deploy | `wdRemote`가 배포 작업을 수행하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | | /source: | 배포할 게임이 있는 개발 PC의 디렉터리입니다. | | /destination: | 게임을 배포할 대상 디바이스의 디렉터리입니다. 이 경로는 Common Root 기준입니다. | | /root: | 선택적 Common Root 별칭입니다. 지정하지 않으면 기본 Common Root가 사용됩니다. | 예제 ``` // c:\gamesource\x64\Debug의 콘텐츠를 기본 Common Root 아래의 Daily라는 디렉터리에 배포합니다. 위의 예제 구성 파일을 사용하면 // 게임은 대상 디바이스의 c:\developmentbuilds\Daily에 배포됩니다. c:\>wdRemote /action:deploy /device:myROGAllyX /source:c:\gamesource\x64\Debug /destination:Daily // \\releases\october2025\buildoutput의 콘텐츠를 d:\releasedbuilds에 있는 Common Root 아래의 october2025라는 디렉터리에 배포합니다. 위의 예제 구성 파일을 사용하면 // 게임은 대상 디바이스의 d:\releasedbuilds\october2025에 배포됩니다. c:\>wdRemote /action:deploy /device:myROGAllyX /source:\\releases\october2025\buildoutput /destination:october2025 ``` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:launch `/device:` 인수로 지정된 원격 디바이스에서 게임을 실행합니다. 실행된 게임의 프로세스 ID가 출력으로 표시됩니다. `wdRemote`는 원격 디바이스에서 한 번에 하나의 게임만 실행되도록 보장합니다. `wdRemote /action:launch`가 실행될 때 이미 원격 디바이스에서 게임이 실행 중이면 새 게임이 시작되기 전에 실행 중인 게임이 종료됩니다. `wdRemote /action:launch /device:HostName | IP Address /path:path to exe in Common Root [/args:list of arguments] [/root:gameRoot alias] [/suspend]` | 옵션 | 설명 | | -------------- | ------------------------------------------------------------------------------------------- | | /action:launch | wdRemote가 실행 작업을 수행하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | | /path: | 실행할 실행 파일의 경로입니다. 상대 경로는 Common Root 아래에서 확인됩니다. 절대 경로가 지정되면 Common Root는 무시됩니다. | | /args: | 실행 파일에 전달할 인수 목록입니다. | | /root: | 선택적 Common Root 별칭입니다. 지정하지 않으면 기본 Common Root가 사용됩니다. | | /suspend: | 게임을 일시 중단된 상태로 실행하는 선택적 플래그입니다. `/suspend`로 실행된 게임을 재개하려면 `wdRemote /action:resume`을 사용하세요. | 예제 ``` // 기본 Common Root에서 게임을 실행하고 게임에 명령줄 인수를 전달합니다. c:\>wdRemote /action:launch /device:myROGAllyX /path:Daily\Game.exe /args:"-level 2" // 일시 중단된 상태로 게임을 실행합니다. c:\>wdRemote /action:launch /device:myROGAllyX /path:Daily\Game.exe /suspend ``` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:resume `/suspend` 플래그와 함께 `wdRemote /action:launch`로 일시 중단된 상태로 실행된 원격 디바이스의 게임을 재개합니다. `wdRemote /action:resume /device:HostName | IP Address` | 옵션 | 설명 | | -------------- | ------------------------------- | | /action:resume | `wdRemote`가 재개 작업을 수행하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | 예제 ``` c:\>wdRemote /action:resume /device:myROGAllyX ``` [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:terminate 원격 디바이스에서 실행 중인 게임을 종료합니다. `wdRemote /action:terminate /device:HostName | IP Address [/processid:id]` | 옵션 | 설명 | | ----------------- | ------------------------------- | | /action:terminate | `wdRemote`가 종료 작업을 수행하도록 지정합니다. | | /device: | 원격 디바이스의 IP 주소 또는 호스트 이름입니다. | | /processid: | 종료할 프로세스의 ID입니다. | [이 항목의 맨 위로 돌아가기.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## 함께 보기 [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) [Xbox PC Remote 도구](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools) ## Related topics - [PC 개발용 명령줄 도구](/ko/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md) - [명령줄 도구](/ko/tools/tools-pc/commandlinetools/index.md) - [XBOX PC Remote Tools 사용 방법](/ko/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md) - [XBOX PC Remote 수신 엔드포인트 (wdEndpoint.exe)](/ko/tools/tools-pc/commandlinetools/gr-wdEndpoint.md) - [XBOX PC Remote Tools: 2026년 3월 (2603) 릴리스 노트](/ko/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)