|
1 | 1 | --- |
2 | | -title: Manage a Microsoft Dev Box dev center |
| 2 | +title: Manage a dev center |
3 | 3 | titleSuffix: Microsoft Dev Box |
4 | | -description: Microsoft Dev Box dev centers help you manage dev box resources, grouping projects with similar settings. Learn how to create, delete, and manage dev centers. |
| 4 | +description: Learn how to create, delete, and manage dev centers to group Microsoft Dev Box projects with similar settings. |
5 | 5 | services: dev-box |
6 | 6 | ms.service: dev-box |
7 | 7 | author: RoseHJM |
8 | 8 | ms.author: rosemalcolm |
9 | | -ms.date: 10/14/2024 |
| 9 | +ms.date: 11/20/2025 |
10 | 10 | ms.topic: how-to |
11 | 11 | #Customer intent: As a platform engineer, I want to be able to manage dev centers so that I can manage my Microsoft Dev Box implementation. |
12 | 12 | --- |
13 | 13 |
|
14 | 14 | # Manage a Microsoft Dev Box dev center |
15 | 15 |
|
16 | | -In this article, you learn how to manage a dev center in Microsoft Dev Box by using the Azure portal. |
| 16 | +Development teams can vary in their functions and needs. A Microsoft Dev Box dev center helps you manage different scenarios by grouping and applying the same settings to similar projects. |
17 | 17 |
|
18 | | -Development teams vary in the way they function and can have different needs. A dev center helps you manage these scenarios by enabling you to group similar sets of projects together and apply similar settings. |
| 18 | +You can create as many dev centers as you need, depending on how you organize and manage your development teams. You can delete dev centers and create new ones to support organizational changes, new business requirements, or new regional centers. |
19 | 19 |
|
20 | | -## Permissions |
| 20 | +You can add users to a dev center to do administrative tasks, and you can attach network connections to dev centers. This article shows you how to use the Azure portal to create and manage a Microsoft Dev Box dev center. |
21 | 21 |
|
22 | | -To manage a dev center, you need the following permissions: |
| 22 | +>[!NOTE] |
| 23 | +>Microsoft Dev Box uses [Microsoft-hosted networks](/windows-365/enterprise/deployment-options#microsoft-hosted-network) to host dev box pools by default. However, you can host dev boxes in your own virtual networks instead. To use your own network with Microsoft Dev Box, you must [create a network connection](how-to-configure-network-connections.md#create-a-network-connection) and then [attach the network connection to a dev center](#attach-network-connection). |
| 24 | + |
| 25 | + ## Permissions |
23 | 26 |
|
24 | | -| Action | Permissions required | |
| 27 | +| Category | Requirement | |
25 | 28 | |---|---| |
26 | | -| _Create or delete a dev center_ | Owner or Contributor permissions on an Azure subscription or a specific resource group. | |
27 | | -| _Manage a dev center_ | Owner or Contributor role, or specific Write permission to the dev center. | |
28 | | -| _Attach or remove a network connection_ | Network Contributor permissions on an existing network connection (Owner or Contributor). | |
| 29 | +| Permissions | - To create or delete a dev center, **Owner** or **Contributor** role in the Azure subscription or resource group.<br> - To manage a dev center, **Owner** or **Contributor** role or specific **Write** permissions to the dev center.<br> - To attach or remove a network connection, **Owner** or **Contributor** role or **Network Contributor** permissions on the network connection. | |
| 30 | +| Connectivity | To attach or remove a network connection, an existing network connection in the same Azure subscription as the dev center. |
| 31 | +| Authentication | To attach or remove a network connection, Microsoft Entra ID for identity and access management and Microsoft Intune for device management. | |
29 | 32 |
|
30 | 33 | ## Create a dev center |
31 | 34 |
|
32 | | -Your development teams' requirements change over time. You can create a new dev center in Microsoft Dev Box to support organizational changes like a new business requirement or a new regional center. |
33 | | - |
34 | | -You can create as many or as few dev centers as you need, depending on how you organize and manage your development teams. |
35 | | - |
36 | | -To create a dev center in the Azure portal: |
| 35 | +To create a dev center in the Azure portal: |
37 | 36 |
|
38 | 37 | [!INCLUDE [create-dev-center-steps](includes/create-dev-center-steps.md)] |
39 | 38 |
|
40 | | -## Delete a dev center |
41 | | - |
42 | | -You might choose to delete a dev center to reflect organizational or workload changes. Deleting a dev center in Microsoft Dev Box is irreversible, and you must prepare for the deletion carefully. |
43 | | - |
44 | | -A dev center can't be deleted while any projects are associated with it. You must delete the projects before you can delete the dev center. |
45 | | - |
46 | | -Attached network connections and their associated virtual networks aren't deleted when you delete a dev center. |
47 | | - |
48 | | -When you're ready to delete your dev center, follow these steps: |
| 39 | +## Assign dev center permissions to users |
49 | 40 |
|
50 | | -1. Sign in to the [Azure portal](https://portal.azure.com). |
| 41 | +You can assign users or groups to the following built-in Azure or Microsoft Dev Box roles. |
51 | 42 |
|
52 | | -1. In the search box, enter **dev centers**. In the search results, select **Dev centers** from the **Services** list. |
| 43 | +- **Owner** grants full access to manage all resources in the dev center, including the ability to assign roles in Azure role-based access control (RBAC). |
| 44 | +- **Contributor** grants full access to manage all resources in the dev center, but not assign roles in Azure RBAC, manage assignments in Azure Blueprints, or share image galleries. |
| 45 | +- **Reader** grants the ability to view all resources in the dev center, but not make any changes. |
| 46 | +- **DevCenter Owner** provides access to manage all Microsoft.DevCenter resources and access to them. |
| 47 | +- **DevCenter Project Admin** provides access to manage project resources. |
| 48 | +- **DevCenter Dev Box User** provides access to create and manage dev boxes and can be granted to users by project admins. |
53 | 49 |
|
54 | | -1. On the **Dev centers** page, open the dev center that you want to delete. |
| 50 | +To assign roles to users: |
55 | 51 |
|
56 | | -1. Select **Delete**. |
| 52 | +1. In the [Azure portal](https://portal.azure.com), go to the page for the dev center you want to assign users to. |
| 53 | +1. On the dev center page, select **Access control (IAM)** in the left navigation menu. |
| 54 | +1. On the **Access control (IAM)** page, select **Add role assignment**. |
| 55 | +1. On the **Role** tab of the **Add role assignment** page, select one of the built-in roles, and then select the **Members** tab. |
| 56 | +1. On the **Members** tab, select **User, group, or service principal**, and then select the **Select members** link. |
| 57 | +1. On the **Select members** screen, search for and select users or groups you want to assign the role, and select **Select**. |
| 58 | +1. Select **Review + assign**, and then select **Review + assign** again. |
57 | 59 |
|
58 | | - :::image type="content" source="./media/how-to-manage-dev-center/delete-dev-center.png" alt-text="Screenshot of the Delete button on the page for a dev center." lightbox="./media/how-to-manage-dev-center/delete-dev-center.png"::: |
59 | | - |
60 | | -1. In the confirmation message, select **OK**. |
| 60 | +For more information, see [Assign Azure roles using the Azure portal](/azure/role-based-access-control/role-assignments-portal). |
61 | 61 |
|
| 62 | +<a name="attach-network-connection"></a> |
62 | 63 | [!INCLUDE [attach or remove a network connection](./includes/attach-remove-network-connections.md)] |
63 | 64 |
|
64 | | -## Assign permissions for users |
65 | | - |
66 | | -You can assign multiple users permissions to a dev center to help with administrative tasks. You can assign users or groups to the following built-in roles: |
67 | | - |
68 | | -- **Owner**: Grants full access to manage all resources, including the ability to assign roles in Azure role-based access control (RBAC). |
69 | | -- **Contributor**: Grants full access to manage all resources, but doesn't allow the user to assign roles in Azure RBAC, manage assignments in Azure Blueprints, or share image galleries. |
70 | | -- **Reader**: Grants the ability to view all resources, but doesn't allow the user to make any changes. |
71 | | - |
72 | | -To make role assignments: |
73 | | - |
74 | | -1. Sign in to the [Azure portal](https://portal.azure.com). |
| 65 | +## Delete a dev center |
75 | 66 |
|
76 | | -1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**. |
| 67 | +You can delete a Microsoft Dev Box dev center to reflect organizational or workload changes. |
77 | 68 |
|
78 | | -1. Select the dev center that you want to give access to. |
| 69 | +- Deleting a dev center is irreversible. |
| 70 | +- You can't delete a dev center that has any projects associated with it. You must delete the projects before you can delete the dev center. |
| 71 | +- Attached network connections and their associated virtual networks aren't deleted when you delete a dev center. |
79 | 72 |
|
80 | | -1. On the left menu, select **Access Control (IAM)**. |
| 73 | +To delete a dev center: |
81 | 74 |
|
82 | | -1. Select **Add** > **Add role assignment**. |
| 75 | +1. In the [Azure portal](https://portal.azure.com), go to the page for the dev center you want to delete. |
| 76 | +1. On the dev center page, select **Delete**. |
83 | 77 |
|
84 | | -1. Assign a role by configuring the following settings. For detailed steps, see [Assign Azure roles using the Azure portal](/azure/role-based-access-control/role-assignments-portal). |
| 78 | + :::image type="content" source="./media/how-to-manage-dev-center/delete-dev-center.png" alt-text="Screenshot of the Delete button on the page for a dev center."::: |
85 | 79 |
|
86 | | - | Setting | Value | |
87 | | - |---|---| |
88 | | - | **Role** | Select **Owner**, **Contributor**, or **Reader**. | |
89 | | - | **Assign access to** | Select **User, group, or service principal**. | |
90 | | - | **Members** | Select the users or groups that you want to be able to access the dev center. | |
| 80 | +1. Select **OK** in the confirmation message. |
91 | 81 |
|
92 | 82 | ## Related content |
93 | 83 |
|
94 | | -- [Provide access to projects for project admins](./how-to-project-admin.md) |
| 84 | +- [Manage a Microsoft Dev Box project](how-to-manage-dev-box-projects.md) |
| 85 | +- [Provide access to projects for project admins](how-to-project-admin.md) |
95 | 86 | - [Create a dev box definition](how-to-manage-dev-box-definitions.md#create-a-dev-box-definition) |
96 | 87 | - [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md) |
0 commit comments