> ## 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 デバイス上でゲームをビルドするために必要な 2 つのワークフローを実現するコマンド ライン ツールです。次の 2 種類のコマンドを使用します。 * 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 とリモート デバイスの間に信頼された安全な接続を確立します。PIN は、リモート デバイス上で実行されている [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) によって生成されます。 `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 の /action:pair に、生成された 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 | `/device:` 引数で指定されたデバイスと開発 PC 間の接続状態を `wdRemote` が表示することを示します。 | | /device: | リモート デバイスの IP アドレスまたはホスト名。 | [このトピックの先頭に戻る。](/tools/tools-pc/commandlinetools/gr-wdRemote) ## アプリケーションのデプロイ、起動、および終了 ### wdRemote /action:deploy 開発 PC から `/device:` 引数で指定されたターゲット デバイスにゲームをデプロイします。すべてのデプロイは増分方式で行われます。つまり、前回のデプロイ以降に変更されたファイルのみがターゲット デバイスに転送されます。 ゲームは、*共通ルート (Common Root)* と呼ばれるディレクトリに保存されます。既定では、Common Root は `%ProgramData%\Microsoft GDK\gameroot` です。`wdRemote` に渡されるデスティネーション パスは、絶対パスを指定した場合を除き、Common Root を基準とした相対パスとして扱われます。絶対パスを指定した場合、Common Root は無視されます。 既定の Common Root の場所を変更したり、Common Root を追加したりするには、`wdEndpoint.json` という名前のファイルを作成し、ターゲット デバイスの `%ProgramData%\Microsoft GDK\wdEndpoint\` に配置します。`wdEndpoint.json` には、次の形式で Common Root のリストが含まれます。 ```json theme={null} { root:, alias:, default:true|false } ``` *default* の指定はオプションです。複数の default が指定されている場合、最初にリストされたものが既定になります。default とマークされたルートがない場合は、最初にリストされたものが既定になります。 以下の例の `wdEndpoint.json` では、2 つの Common Root を定義しています。1 つは `c:\developmentbuilds` にある既定のルート、もう 1 つは `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` は、リモート デバイス上で一度に 1 つのゲームのみが実行されることを保証します。`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 tools](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools) ## Related topics - [コマンドライン ツール](/ja-jp/tools/tools-pc/commandlinetools/index.md) - [XBOX PC Remote Tools の使用方法](/ja-jp/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md) - [XBOX PC リモート リスニング エンドポイント (wdEndpoint.exe)](/ja-jp/tools/tools-pc/commandlinetools/gr-wdEndpoint.md) - [XBOX PC Remote Tools: 2026 年 3 月 (2603) リリース ノート](/ja-jp/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md) - [XBOX PC Remote Tools](/ja-jp/tools/tools-pc/xbox-pc-remote-tools/index.md)