원격 Windows 개발(wdRemote.exe)

원격 Windows 개발(wdRemote.exe)은 원격 Windows 디바이스에서 게임을 빌드하는 데 필요한 두 개의 워크플로를 사용하도록 설정하는 명령줄 도구입니다. 다음 두 명령을 사용하여 다음을 수행합니다.

• PIN 페어링을 사용하여 개발 PC와 원격 디바이스 간에 신뢰할 수 있는 보안 연결을 설정합니다.
• 원격 Windows 디바이스에서 게임을 배포, 시작 및 종료합니다.

wdRemote는 개발 PC에서 실행되고 원격 디바이스에서 실행되는 wdEndpoint.exeinstance 통신합니다. Windows 디바이스 용 원격 개발 도구 제품군의 역할 wdRemote 및 wdEndpoint 플레이에 대한 설명은 원격 Windows 개발 도구 개요를 참조하세요.

Xbox PC 도구 상자 또는 WinGet을 사용하여 개발 PC에 설치 wdRemote 합니다.

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]

예제:

// Start the pairing process by obtaining a pin using `wdEndpoint /pair` on the remote device.  `wdEndpoint /pair` must be executed from a command prompt with Administrator privileges
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
Game 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  

// Specify the result PIN to the pairing /action to wdRemote on the desktop PC
c:>wdRemote /action:pair /device:myROGAllyX /pin:q87p7w

Successfully paired.
Client: a701ed911d794154737a1ed2cfe29e292d532561
Device: 231d6063b48cfc136f8ebdcad0a472edc7a27527

이 항목의 맨 위쪽으로 돌아갑니다.

wdRemote /action:purgekeys

와 wdEndpoint 간의 wdRemote 모든 트래픽이 암호화됩니다. wdRemote 는 원격 디바이스에 연결하라는 메시지가 처음 표시될 때 필요한 암호화 키와 인증서를 자동으로 만듭니다. 이러한 키는 페어링 프로세스에도 사용됩니다.

wdRemote /action:purgekeys 는 개발 PC에서 모든 키 및 디바이스 페어링을 제거합니다.

wdRemote /action:purgekeys

이 항목의 맨 위쪽으로 돌아갑니다.

상태 및 버전 관리 정보

wdRemote /action:version

wdRemote.exe 버전을 표시합니다.

wdRemote /action:version

이 항목의 맨 위쪽으로 돌아갑니다.

wdRemote /action:상태

개발 PC와 대상 디바이스 간의 연결 상태 표시합니다. wdRemote /action:pair 는 모든 디바이스 페어링을 확인하고 암호화가 적용되는지 확인합니다.

wdRemote /action:status /device:HostName | IP Address

이 항목의 맨 위쪽으로 돌아갑니다.

애플리케이션 배포, 시작 및 종료

wdRemote /action:deploy

개발 PC에서 인수로 지정된 /device: 대상 디바이스에 게임을 배포합니다. 모든 배포는 증분입니다. 즉, 마지막 배포 이후 변경된 파일만 대상 디바이스로 전송됩니다.

게임은 게임 루트라는 디렉터리의 대상 디바이스에 저장됩니다. 기본적으로 게임 루트는 입니다 C:\%ProgramData%\Microsoft GDK\wdEndpoint\gameroot. 에 전달된 wdRemote 모든 대상 경로는 게임 루트를 기준으로 합니다.

라는 wdEndpoint.json 파일을 만들어 대상 디바이스에 배치 C:\%ProgramData%\Microsoft GDK\wdEndpoint\ 하여 기본 게임 루트의 위치를 변경하고 추가 게임 루트를 추가할 수 있습니다. wdEndpoint.json 에는 다음 형식의 게임 루트 목록이 포함되어 있습니다.

{
  root:<absolute file path>,
  alias:<name>,
  default:true|false
}

기본값 지정은 선택 사항입니다. 여러 기본값을 지정하면 나열된 첫 번째 기본값이 기본값이 됩니다. 루트가 기본값으로 표시되지 않으면 나열된 첫 번째 루트가 기본값이 됩니다.

다음 예제 wdEndpoint.json 에서는 의 기본 루트와 에 추가 루트 c:\developmentbuilds 인 두 개의 게임 루트 d:\releasedbuilds를 정의합니다.

{
    "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]

예제

// Deploys the contents of c:\gamesource\x64\Debug to a directory named Daily under the default game root.  Using the example config file above, the game
// will be deployed to c:\developmentbuilds\Daily on the target device.
c:\>wdRemote /action:deploy /device:myROGAllyX /source:c:\gamesource\x64\Debug /destination:Daily

// Deploys the contents of \\releases\october2025\buildoutput to a directory named october2025 under the game root at d:\releasedbuilds.  Using the example config file above,
// the game will be deployed to d:\releasedbuilds\october2025 on the target device.
c:\>wdRemote /action:deploy /device:myROGAllyX /source:\\releases\october2025\buildoutput /destination:october2025

이 항목의 맨 위쪽으로 돌아갑니다.

wdRemote /action:launch

인수로 지정된 /device: 원격 디바이스에서 게임을 시작합니다. 시작된 게임의 프로세스 ID가 출력으로 표시됩니다. wdRemote 는 원격 디바이스에서 한 번에 하나의 게임만 실행되도록 보장합니다. 이 실행될 때 wdRemote /action:launch 게임이 원격 장치에서 이미 실행 중인 경우 새 게임이 시작되기 전에 실행 중인 게임이 종료됩니다.

wdRemote /action:launch /device:HostName | IP Address /path:path to exe in game root [/args:list of arguments] [/root:gameRoot alias]

예제

// Launches a game in the default game root, passing a command line argument to the game
c:\>wdRemote /action:launch /device:myROGAllyX /path:Daily\Game.exe /args:"-level 2"

이 항목의 맨 위쪽으로 돌아갑니다.

wdRemote /action:terminate

원격 디바이스에서 실행되는 게임을 종료합니다.

wdRemote /action:terminate /device:HostName | IP Address [/processid:id]

이 항목의 맨 위쪽으로 돌아갑니다.

참고 항목

wdEndpoint
원격 Windows 개발 도구