how-to-manage-dev-box-pools.md

title	titleSuffix	description	services	ms.service	author	ms.author	ms.date	ms.topic
Manage a dev box pool	Microsoft Dev Box	Microsoft Dev Box dev box pools are collections of dev boxes that you manage together. Learn how to create, configure, and delete dev box pools.	dev-box	dev-box	RoseHJM	rosemalcolm	10/12/2022	how-to

Manage a dev box pool

To allow developers to create their own dev boxes, you need to set up dev box pools that define the dev box specifications and network connections for new dev boxes. Developers can then create dev boxes from the dev box pools they have access to through their project memberships.

Permissions

To manage a dev box pool, you need the following permissions:

Action	Permissions required
Create, delete, or update a dev box pool	Owner or Contributor permissions on an Azure subscription or a specific resource group. DevCenter Project Admin permissions for the project.

Create a dev box pool

A dev box pool is a collection of dev boxes that you manage together. You must have a pool before users can create a dev box.

The following steps show you how to create a dev box pool that's associated with a project. You'll use an existing dev box definition and network connection in the dev center to configure the pool.

If you don't have an available dev center with an existing dev box definition and network connection, follow the steps in Quickstart: Configure Microsoft Dev Box Preview to create them.

1. Sign in to the Azure portal.

2. In the search box, enter projects. In the list of results, select Projects.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/discover-projects.png" alt-text="Screenshot that shows a search for projects from the Azure portal search box.":::

3. Open the project with which you want to associate the new dev box pool.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/projects-grid.png" alt-text="Screenshot of the list of existing projects.":::

4. Select Dev box pools, and then select Create.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-empty.png" alt-text="Screenshot of the empty list of dev box pools within a project, along with the Create button.":::

5. On the Create a dev box pool pane, enter the following values:

   Name	Value
   Name	Enter a name for the pool. The pool name is visible to developers to select when they're creating dev boxes. It must be unique within a project.
   Dev box definition	Select an existing dev box definition. The definition determines the base image and size for the dev boxes that are created in this pool.
   Network connection	Select an existing network connection. The network connection determines the region of the dev boxes that are created in this pool.
   Dev box Creator Privileges	Select Local Administrator or Standard User.
   Enable Auto-stop	Yes is the default. Select No to disable an auto-stop schedule. You can configure an auto-stop schedule after the pool is created.
   Stop time	Select a time to shut down all the dev boxes in the pool.
   Time zone	Select the time zone that the stop time is in.
   Licensing	Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-create.png" alt-text="Screenshot of the pane for creating a dev box pool.":::

6. Select Add.

7. Verify that the new dev box pool appears in the list. You might need to refresh the screen.

The Azure portal deploys the dev box pool and runs health checks to ensure that the image and network pass the validation criteria for dev boxes. The following screenshot shows four dev box pools, each with a different status.

:::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-populated.png" alt-text="Screenshot that shows a list of dev box pools and status information.":::

Delete a dev box pool

You can delete a dev box pool when you're no longer using it.

Caution

When you delete a dev box pool, all existing dev boxes within the pool are permanently deleted.

1. Sign in to the Azure portal.

2. In the search box, enter projects. In the list of results, select Projects.

3. Open the project from which you want to delete the dev box pool.

4. Select the dev box pool you that you want to delete, and then select Delete.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-delete.png" alt-text="Screenshot of a selected dev box pool in the list of dev box pools, along with the Delete button.":::

5. In the confirmation message, select Continue.

   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-delete-confirm.png" alt-text="Screenshot of the confirmation message for deleting a dev box pool.":::

Next steps

• Provide access to projects for project admins
• 3. Create a dev box definition
• Configure Azure Compute Gallery