Freigeben über


Xbox PC Toolbox

Important

The Xbox PC Toolbox app is in preview. To learn more, contact your Microsoft representative.

Xbox PC Toolbox lets you provision and iterate on Windows-based devices remotely. Use the graphical app, installed on both your development PC and target device, to launch, deploy, and terminate processes on paired devices selected in the device workspace..

Note

We value your feedback. To suggest features or report issues, select Send Feedback in the app or email xboxpcrtfeedback@microsoft.com](xboxpcrtfeedback@microsoft.com).

User Interface

The Xbox PC Toolbox app interface includes these main areas:

  • [Device Workspace]: Discover paired devices, install tools, and connect for remote workflows like launching, deploying, and terminating apps.
  • [Pair device]: Add a new device by entering its alias, IP address or device name, username, and a unique PIN. If the PIN isn’t used within 2 minutes, a new one is generated.
  • [Connect]: Select a target device and use the Connect button to start a PowerShell session. Use wdRemote and wdEndpoint to deploy, launch, and terminate games from the command line.
  • [Install tools]: Install development tools on your PC or target device.

Screenshot of the Xbox PC Toolbox app interface

Using Xbox PC Toolbox

Get started

  1. Download Xbox PC Toolbox from the Microsoft Store on Windows.
  2. Pair your devices and complete setup.
  3. Begin using your remote development environment.

Prerequisites

  • Both devices must run the latest version of Windows Home or Pro.
  • Sign in to the target device with your personal Microsoft account (MSA).
  • Administrator privileges are required on both devices.
  • Both devices must be on the same wired or wireless network.
  • Avoid custom sandbox environments from the Microsoft Store.

Note

If you participated in a previous preview, follow the cleanup instructions before proceeding.

Deploy a game build

Xbox PC Toolbox installs the command-line tool wdRemote.exe on your development PC and wdEndpoint on the target device. To deploy your game:

wdRemote /action:deploy /device:mypc1 /source:c:\game /destination:gamedir

This command copies your game files incrementally to the target’s game directory.

Note

The default directory is: C:\ProgramData\Microsoft\GDK\wdEndpoint\gameroot\GameDir

Launch a game

After deployment, launch the game on the target device:

wdRemote /action:launch /device:mypc1 /path:gamedir\game.exe

The game starts on the target hardware.

Terminate a game

To end a game process, use the process ID from the Toolbox app:

wdRemote /action:terminate /device:mypc1 /processid:1234

Send feedback

Report issues or suggest improvements using the Feedback Hub in the Xbox PC Toolbox app:

  1. Select Send Feedback from the app’s title bar.
  2. Choose Report a Problem. Screenshot of the Send Feedback drop-down menu in feedback hub
  3. Enter your feedback details and select Next. Screenshot of the feedback dialog box in Xbox PC Toolbox app
  4. Choose a category: Problem or Suggestion under Gaming and Xbox > Developer Tools, then select Next. Screenshot of the category in feedback hub
  5. Add new feedback or select a matching option.
  6. If the issue blocks your workflow, check the box and select the best description. Screenshot of feedback hub
  7. Attach files if needed and select Submit. Screenshot of the final tab in Feedback hub

From the Xbox PC Toolbox title bar, select Send Feedback. Then select Report a Problem as shown in the following screenshot:

Screenshot of the Send Feedback drop-down menu in feedback hub

For a detailed walkthrough on how to start provisioning and iterating on remote Windows devices via the Xbox PC Toolbox app, see the Remote Windows Game development how-to guide.