संपादित करें

इसके माध्यम से साझा किया गया


Create reusable dev box customizations with Dev Home Preview

In this article, you learn how to use Dev Home Preview to create, customize, and connect to your dev box. Dev Home is a Windows application that helps you manage and interact with your dev boxes.

Important

Microsoft Dev Home is currently in PREVIEW. This information relates to a prerelease product that may be substantially modified before it's released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.

Prerequisites

To complete the steps in this article, you must:

Install or update Dev Home

You might see Dev Home in the Start menu. If you see it there, you can select it to open the app.

Dev Home is available in the Microsoft Store. To install or update Dev Home, go to the Dev Home (Preview) page in the Microsoft Store and select Get or Update.

Sign in to Dev Home

Dev Home allows you to work with many different services, like Microsoft Hyper-V, Windows Subsystem for Linux (WSL), and Microsoft Dev Box. To access your chosen service, you must sign in to your Microsoft account, or your Work or School account.

To sign in:

  1. Open Dev Home.

  2. From the left menu, select Settings.

    Screenshot of Dev Home, showing the home page with Settings highlighted.

  3. Select Accounts.

    Screenshot of Dev Home, showing the Settings page with Accounts highlighted.

  4. Select Add account and follow the prompts to sign in.

    Screenshot of Dev Home, showing the Accounts page with Add account highlighted.

Add extensions

Dev Home uses extensions to provide more functionality. To support the Dev Box features, you need to install the Dev Home Azure Extension.

To add an extension:

  1. In Dev Home, from the left menu, select Extensions.

    Screenshot of Dev Home, showing the Extensions page.

  2. In the list of extensions Available in the Microsoft Store, on the Dev Home Azure Extension (Preview), select Get.

    Screenshot of Dev Home, showing the Extensions page with the Dev Home Azure Extension highlighted.

  3. In the Microsoft Store dialog, select Get to install the extension.

    Screenshot of the Microsoft Store dialog with the Get button highlighted.

Create a dev box

Dev Home provides a guided way for you to create a new dev box.

Note

Dev Home uses the term Environments to refer to all local and cloud virtual machines.

To create a new dev box:

  1. In Dev Home, from the left menu, select Environments.

    Screenshot of Dev Home, showing the Environments page.

  2. Select Create Environment.

    Screenshot of Dev Home, showing the Environments page with Create Environment highlighted.

  3. On the Select environment page, select Microsoft DevBox, and then select Next.

    Screenshot of Dev Home, showing the Select environment page with Microsoft Dev Box highlighted.

  4. On the Configure your environment page:

    • Enter a name for your dev box.

    • Select the Project you want to create the dev box in.

    • Select the DevBox Pool where you want to create the dev box. Select a pool located close to you to reduce latency.

    • Select Next.

      Screenshot showing the Configure your environment page.

  5. On the Review your environment page, review the details and select Create environment.

    Screenshot showing the Review your environment page.

  6. Select Go to Environments to see the status of your dev box.

    Screenshot showing the Go to Environments button.

Important

A dev box is automatically started and running when the creation process finishes. Dev boxes incur costs whenever they're running.

Connect to your dev box

Dev Home provides a seamless way for you to use the Windows App to connect to your Dev Box from any device of your choice. You can customize the look and feel of the Windows App to suit the way you work, and switch between multiple services across accounts.

If the Windows App isn't installed, selecting Launch takes you to the web client to launch the Dev Box. Dev Home provides a way to launch your dev box straight from the app.

Install the Windows App

  1. Go to the Microsoft store and search for Windows App or use this download link:.
  2. Download the app and install it.

Launch your dev box

  1. In Dev Home, from the left menu, select Environments.

  2. For the dev box you want to launch, select Launch.

    Screenshot showing a dev box with the Launch menu highlighted.

  3. You can also start and stop the dev box from the Launch menu.

    Screenshot of the Launch menu with Start and Stop options.

For more information on the Windows App, see Windows App.

Manage your dev box

Dev home enables you to pin your dev box to the start menu or task bar, and to delete your dev box.

  1. Open Dev Home.

  2. From the left menu, select Environments.

  3. Select the dev box you want to manage.

  4. Select Pin to start, Pin to taskbar, or Delete.

    Screenshot showing a dev box with the Pin to start, Pin to taskbar, and Delete options highlighted.

Customize an existing dev box

Dev home gives you the opportunity to clone repositories and add software to your existing dev box. Dev home uses the Winget catalog to provide a list of software that you can install on your dev box.

  1. Open Dev Home.

  2. From the left menu, select Machine configuration.

    Screenshot showing Dev Home with Machine configuration highlighted.

  3. Select Set up an environment.

    Screenshot showing the Machine configuration page with Set up environment highlighted.

  4. Select the environment you want to customize, and then select Next.

    Screenshot showing the Select environment page.

  5. On the Set up an environment page, if you want to clone a repository to your dev box, select Add repository.

    Screenshot showing the Add repository button.

  6. In the Add repository dialog, enter the source and destination paths for the repository you want to clone, and then select Add.

    Screenshot showing the Add repository dialog box.

  7. When you finish adding repositories, select Next.

    Screenshot showing the repositories to add, with the Next button highlighted dialog box.

  8. Next, you can choose software to install. From the list of applications Winget provides, choose the software you want to install on your dev box. You can also search for software by name.

    Screenshot showing the Add software page with Visual Studio Community and PowerShell highlighted.

  9. When you finish selecting software, select Next.

    Screenshot showing the Add software page with Next highlighted.

  10. On the Review and finish page, under See details:

    1. Select the Environment tab to see the virtual machine you're configuring.
    2. Select the Applications tab to see a list of the software you're installing.
    3. Select the Repositories tab to see the list of public GitHub repositories you're cloning.
  11. Select I agree and want to continue, and then select Set up.

    Screenshot showing the Review and finish page with the I agree and want to continue button highlighted.

Notice that you can also generate a configuration file based on your selected repositories and software to use in the future to create dev boxes with the same customizations.

Screenshot showing the Review and finish page with the Generate configuration file button highlighted.