XBOX PC Toolbox 앱은 미리 보기 상태입니다. Windows의 Microsoft Store에서 다운로드하세요.
- PIN 페어링을 사용하여 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다.
- 원격 Windows 디바이스에서 게임을 배포, 실행, 종료합니다.
wdRemote는 개발 PC에서 실행되며, 원격 디바이스에서 실행 중인 wdEndpoint.exe 인스턴스와 통신합니다. Windows 디바이스용 원격 개발 도구 모음에서 wdRemote와 wdEndpoint가 수행하는 역할에 대한 설명은 XBOX PC Remote 도구 개요를 참조하세요.
개발 PC에 wdRemote를 설치하려면 XBOX PC Toolbox 또는 WinGet을 사용하세요.
winget install Microsoft.Gaming.RemoteIterationClient
다음 표에 나열된 명령을 실행하려면 wdRemote를 사용하세요.
원격 Windows 디바이스 페어링 및 보안 키 관리
wdRemote /action:pair
이 명령은 PIN 페어링을 통해 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다. 원격 디바이스에서 실행 중인 wdEndpoint가 PIN을 생성합니다.wdRemote /action:pair /device:HostName | IP Address /pin:pin number [/sshKey:filename]
예제:
wdRemote /action:purgekeys
wdRemote와 wdEndpoint 간의 모든 트래픽은 암호화됩니다. wdRemote는 원격 디바이스에 처음 연결을 요청받을 때 필요한 암호화 키와 인증서를 자동으로 생성합니다. 이러한 키는 페어링 과정에서도 사용됩니다.
wdRemote /action:purgekeys는 개발 PC에서 모든 키와 디바이스 페어링을 제거합니다.
wdRemote /action:purgekeys
이 항목의 맨 위로 돌아가기.
상태 및 버전 정보
wdRemote /action:version
wdRemote.exe의 버전을 표시합니다.wdRemote /action:version
이 항목의 맨 위로 돌아가기.
wdRemote /action:status
개발 PC와 대상 디바이스 간의 연결 상태를 표시합니다.wdRemote /action:pair는 모든 디바이스 페어링을 확인하고 암호화가 적용되고 있는지 검사합니다.
wdRemote /action:status /device:HostName | IP Address
이 항목의 맨 위로 돌아가기.
애플리케이션 배포, 실행, 종료
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 목록을 포함합니다.
wdEndpoint.json은 두 개의 Common Root를 정의하며, 기본 루트는 c:\developmentbuilds이고 다른 루트는 d:\releasedbuilds입니다.
wdRemote /action:deploy /device:HostName | IP Address /source:directory /destination:folder under gameRoot [/root:gameRoot alias]
예제
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]
예제
wdRemote /action:resume
/suspend 플래그와 함께 wdRemote /action:launch로 일시 중단된 상태로 실행된 원격 디바이스의 게임을 재개합니다.
wdRemote /action:resume /device:HostName | IP Address
예제
wdRemote /action:terminate
원격 디바이스에서 실행 중인 게임을 종료합니다.wdRemote /action:terminate /device:HostName | IP Address [/processid:id]
이 항목의 맨 위로 돌아가기.
