Merge pull request #262330 from GitHubber17/183368-12

Freshness | Microsoft Dev Box procedures

Author: JamesJBarnett

articles/dev-box/how-to-configure-network-connections.md

@@ -6,7 +6,7 @@ services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 12/20/2023
+ms.date: 01/12/2024
 ms.topic: how-to
 #Customer intent: As a platform engineer, I want to be able to manage network connections so that I can enable dev boxes to connect to my existing networks and deploy them in the desired region.
 ---
@@ -161,47 +161,7 @@ Microsoft Dev Box requires a configured and working Active Directory join, which
 > [!NOTE]
 > Microsoft Dev Box automatically creates a resource group for each network connection, which holds the network interface cards (NICs) that use the virtual network assigned to the network connection. The resource group has a fixed name based on the name and region of the network connection. You can't change the name of the resource group, or specify an existing resource group.
 
-## Attach a network connection to a dev center
-
-You need to attach a network connection to a dev center before you can use it in projects to create dev box pools.
-
-1. Sign in to the [Azure portal](https://portal.azure.com).
-
-1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
-
-1. Select the dev center that you created, and then select **Networking**.
-
-1. Select **+ Add**.
-
-1. On the **Add network connection** pane, select the network connection that you created earlier, and then select **Add**.
-
-   :::image type="content" source="./media/how-to-manage-network-connection/add-network-connection.png" alt-text="Screenshot that shows the pane for adding a network connection." lightbox="./media/how-to-manage-network-connection/add-network-connection.png":::
-
-After you attach a network connection, the Azure portal runs several health checks on the network. You can view the status of the checks on the resource overview page.
-
-:::image type="content" source="./media/how-to-manage-network-connection/network-connection-grid-populated.png" alt-text="Screenshot that shows the status of a network connection.":::
-
-You can add network connections that pass all health checks to a dev center and use them to create dev box pools. Dev boxes within dev box pools are created and domain joined in the location of the virtual network assigned to the network connection.
-
-To resolve any errors, see [Troubleshoot Azure network connections](/windows-365/enterprise/troubleshoot-azure-network-connection).
-
-## Remove a network connection from a dev center
-
-You can remove a network connection from a dev center if you no longer want to use it to connect to network resources. Network connections can't be removed if one or more dev box pools are using them.
-
-1. Sign in to the [Azure portal](https://portal.azure.com).
-
-1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
-
-1. Select the dev center that you created, and then select **Networking**.
-
-1. Select the network connection that you want to remove, and then select **Remove**.
-
-   :::image type="content" source="./media/how-to-manage-network-connection/remove-network-connection.png" alt-text="Screenshot that shows the Remove button on the network connection page.":::
-
-1. Review the warning message, and then select **OK**.
-
-The network connection is no longer available for use in the dev center.
+[!INCLUDE [attach or remove a network connection.](./includes/attach-remove-network-connections.md)]
 
 ## Related content
 

articles/dev-box/how-to-manage-dev-center.md

@@ -1,12 +1,12 @@
 ---
-title: Manage a dev center
+title: Manage a Microsoft Dev Box dev center
 titleSuffix: Microsoft Dev Box
 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.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 04/25/2023
+ms.date: 01/12/2024
 ms.topic: how-to
 #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.
 ---
@@ -15,17 +15,17 @@ ms.topic: how-to
 
 In this article, you learn how to manage a dev center in Microsoft Dev Box by using the Azure portal.
 
-Development teams vary in the way they function and might 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.
+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.
 
 ## Permissions
 
 To manage a dev center, you need the following permissions:
 
-|Action|Permissions required|
-|-----|-----|
-|Create or delete a dev center|Owner or Contributor permissions on an Azure subscription or a specific resource group.|
-|Manage a dev center|Owner or Contributor role, or specific Write permission to the dev center.|
-|Attach or remove a network connection|Network Contributor permissions on an existing network connection (Owner or Contributor).|
+| Action | Permissions required |
+|---|---|
+| _Create or delete a dev center_ | Owner or Contributor permissions on an Azure subscription or a specific resource group. |
+| _Manage a dev center_ | Owner or Contributor role, or specific Write permission to the dev center. |
+| _Attach or remove a network connection_ | Network Contributor permissions on an existing network connection (Owner or Contributor). |
 
 ## Create a dev center
 
@@ -39,46 +39,46 @@ To create a dev center in the Azure portal:
 
 1. In the search box, enter **dev centers**. In the search results, select **Dev centers** from the **Services** list.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/search-dev-center.png" alt-text="Screenshot that shows the search box and list of services on the Azure portal.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/search-dev-center.png" alt-text="Screenshot that shows the Azure portal with the search box and the result for dev centers." lightbox="./media/how-to-manage-dev-center/search-dev-center.png":::
 
 1. On the **Dev centers** page, select **Create**.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center.png" alt-text="Screenshot that shows the Create button on the page for dev centers.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center.png" alt-text="Screenshot that shows the Azure portal with the Create button on the page for dev centers." lightbox="./media/how-to-manage-dev-center/create-dev-center.png":::
 
 1. On the **Create a dev center** pane, on the **Basics** tab, enter the following values:
 
-   |Name|Value|
-   |----|----|
-   |**Subscription**|Select the subscription in which you want to create the dev center.|
-   |**ResourceGroup**|Select an existing resource group, or select **Create new** and then enter a name for the new resource group.|
-   |**Name**|Enter a name for the dev center.|
-   |**Location**|Select the location or region where you want to create the dev center.|
+   | Setting | Value |
+   |---|---|
+   | **Subscription** | Select the subscription in which you want to create the dev center. |
+   | **ResourceGroup** | Select an existing resource group, or select **Create new** and then enter a name for the new resource group. |
+   | **Name** | Enter a name for your dev center. |
+   | **Location** | Select the location or region where you want the dev center to be created. |
 
-   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-basics.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a dev center.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-basics.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a dev center." lightbox="./media/how-to-manage-dev-center/create-dev-center-basics.png":::
 
-   For a list of supported Azure locations with capacity, see [Frequently asked questions about Microsoft Dev Box](https://aka.ms/devbox_acom).
+   For a list of the currently supported Azure locations with capacity, see [Frequently asked questions about Microsoft Dev Box](https://aka.ms/devbox_acom).
 
 1. (Optional) On the **Tags** tab, enter a name/value pair that you want to assign.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-tags.png" alt-text="Screenshot that shows the Tags tab on the page for creating a dev center.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-tags.png" alt-text="Screenshot that shows the Tags tab on the page for creating a dev center." lightbox="./media/how-to-manage-dev-center/create-dev-center-tags.png":::
 
 1. Select **Review + Create**.
 
 1. On the **Review** tab, select **Create**.
 
 1. Monitor the progress of the dev center creation from any page in the Azure portal by opening the **Notifications** pane.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/azure-notifications.png" alt-text="Screenshot that shows the Notifications pane in the Azure portal.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/azure-notifications.png" alt-text="Screenshot that shows the Notifications pane in the Azure portal." lightbox="./media/how-to-manage-dev-center/azure-notifications.png":::
 
-1. When the deployment is complete, select **Go to resource** and confirm that the dev center appears on the **Dev centers** page.
+1. When the deployment completes, select **Go to resource**. Confirm that the dev center page appears.
 
 ## Delete a dev center
 
 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.
 
 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.
 
-Attached network connections and their associated virtual networks are not deleted when you delete a dev center.
+Attached network connections and their associated virtual networks aren't deleted when you delete a dev center.
 
 When you're ready to delete your dev center, follow these steps:
 
@@ -90,51 +90,19 @@ When you're ready to delete your dev center, follow these steps:
 
 1. Select **Delete**.
 
-    :::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.":::
+   :::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":::
 
 1. In the confirmation message, select **OK**.
 
-## Attach a network connection
-
-You can attach existing network connections to a dev center. You must attach a network connection to a dev center before you can use it in projects to create dev box pools.
-
-Network connections enable dev boxes to connect to existing virtual networks. The location, or Azure region, of the network connection determines where associated dev boxes are hosted.
-
-To attach a network connection to a dev center in Microsoft Dev Box:
-
-1. Sign in to the [Azure portal](https://portal.azure.com).
-
-1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
-
-1. Select the dev center that you want to attach the network connection to, and then select **Networking**.
-
-1. Select **+ Add**.
-
-1. On the **Add network connection** pane, select the network connection that you created earlier, and then select **Add**.
-
-## Remove a network connection
-
-You can remove network connections from dev centers. Network connections can't be removed if one or more dev box pools are using them. When you remove a network connection, it's no longer available for use in dev box pools within the dev center.
-
-1. Sign in to the [Azure portal](https://portal.azure.com).
-
-1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
-
-1. Select the dev center that you want to detach the network connection from, and then select **Networking**.
-
-1. Select the network connection that you want to detach, and then select **Remove**.
-
-1. In the confirmation message, select **OK**.
+[!INCLUDE [attach or remove a network connection](./includes/attach-remove-network-connections.md)]
 
 ## Assign permissions for users
 
 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:
 
-|**Role**|**Description**|
-|-----|-----|
-|**Owner**|Grants full access to manage all resources, including the ability to assign roles in Azure role-based access control (RBAC).|
-|**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.|
-|**Reader**|Grants the ability to view all resources, but doesn't allow the user to make any changes.|
+- **Owner**: Grants full access to manage all resources, including the ability to assign roles in Azure role-based access control (RBAC).
+- **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.
+- **Reader**: Grants the ability to view all resources, but doesn't allow the user to make any changes.
 
 To make role assignments:
 
@@ -148,16 +116,16 @@ To make role assignments:
 
 1. Select **Add** > **Add role assignment**.
 
-1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+1. Assign a role by configuring the following settings. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
 
     | Setting | Value |
-    | --- | --- |
+    |---|---|
     | **Role** | Select **Owner**, **Contributor**, or **Reader**. |
     | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups that you want to be able to access the dev center. |
 
 ## Related content
 
 - [Provide access to projects for project admins](./how-to-project-admin.md)
-- [2. Create a dev box definition](quickstart-configure-dev-box-service.md#create-a-dev-box-definition)
+- [Create a dev box definition](quickstart-configure-dev-box-service.md#create-a-dev-box-definition)
 - [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md)

articles/dev-box/includes/attach-remove-network-connections.md

@@ -0,0 +1,53 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 01/12/2024
+ms.topic: include
+ms.service: dev-box
+---
+
+## Attach a network connection to a dev center
+
+You can attach existing network connections to a dev center. You must attach a network connection to a dev center before you can use it in projects to create dev box pools.
+
+Network connections enable dev boxes to connect to existing virtual networks. The location, or Azure region, of the network connection determines where associated dev boxes are hosted.
+
+To attach a network connection to a dev center in Microsoft Dev Box:
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
+
+1. Select the dev center that you created, and then select **Networking**.
+
+1. Select **+ Add**.
+
+1. On the **Add network connection** pane, select the network connection that you created earlier, and then select **Add**.
+
+   :::image type="content" source="../media/how-to-manage-network-connection/add-network-connection.png" alt-text="Screenshot that shows the pane for adding a network connection." lightbox="../media/how-to-manage-network-connection/add-network-connection.png":::
+
+After you attach a network connection, the Azure portal runs several health checks on the network. You can view the status of the checks on the resource overview page.
+
+:::image type="content" source="../media/how-to-manage-network-connection/network-connection-grid-populated.png" alt-text="Screenshot that shows the status of a network connection." lightbox="../media/how-to-manage-network-connection/network-connection-grid-populated.png" :::
+
+You can add network connections that pass all health checks to a dev center and use them to create dev box pools. Dev boxes within dev box pools are created and domain joined in the location of the virtual network assigned to the network connection.
+
+To resolve any errors, see [Troubleshoot Azure network connections](/windows-365/enterprise/troubleshoot-azure-network-connection).
+
+## Remove a network connection from a dev center
+
+You can remove network connections from dev centers. Network connections can't be removed if one or more dev box pools are using them.
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
+
+1. Select the dev center that you created, and then select **Networking**.
+
+1. Select the network connection that you want to remove, and then select **Remove**.
+
+   :::image type="content" source="../media/how-to-manage-network-connection/remove-network-connection.png" alt-text="Screenshot that shows the Remove button on the network connection page." lightbox="../media/how-to-manage-network-connection/remove-network-connection.png":::
+
+1. Review the warning message, and then select **OK**.
+
+After you remove a network connection, it's no longer available for use in dev box pools within the dev center.