Merge pull request #304731 from GitHubber17/476230-a

Freshness Edit - Dev Box

Author: JillGrant615

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

@@ -1,12 +1,12 @@
 ---
-title: Configure network connections
+title: Configure Network Connections
 titleSuffix: Microsoft Dev Box
 description: Learn how to manage network connections for a dev center in Microsoft Dev Box. Connect to a virtual network or enable connecting to on-premises resources.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 01/12/2024
+ms.date: 08/27/2025
 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.
 ---
@@ -31,7 +31,7 @@ When you're planning network connectivity for your dev boxes, consider the follo
 
 ### Verify your permissions
 
-To manage a network connection, confirm that you have the following permissions:
+To manage a network connection, confirm you have the following permissions:
 
 | Action | Role | Permissions required |
 |---|---|---|
@@ -41,35 +41,37 @@ To manage a network connection, confirm that you have the following permissions:
 
 ## Create a virtual network and subnet
 
-To create a network connection, you need an existing virtual network and subnet. If you don't have a virtual network and subnet available, use the following steps to create them:
+To create a network connection, you need an existing virtual network and subnet. If you don't have a virtual network and subnet available, use the following steps to create these resources:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **virtual network**. In the list of results, select **Virtual Network**.
+1. In the search box, enter **virtual network**. In the list of results, select **Virtual networks**.
 
-1. On the **Virtual Network** page, select **Create**.
+1. On the **Virtual networks** page, select **+ Create**.
 
-1. On the **Create virtual network** pane, on the **Basics** tab, enter the following values:
+1. On the **Create virtual network** pane, configure the following values on the **Basics** tab:
 
-    | Setting | Value |
-    |---|---|
-    | **Subscription** | Select your subscription. |
-    | **Resource group** | Select an existing resource group, or create a new one by selecting **Create new**, entering a name, and then selecting **OK**. |
-    | **Name** | Enter a name for the virtual network. |
-    | **Region** | Select the region for the virtual network and dev boxes. |
+   | Setting | Value |
+   |---|---|
+   | **Subscription** | Select your subscription. |
+   | **Resource group** | Select an existing resource group, or create a new resource by selecting **Create new**, entering a name, and then selecting **OK**. |
+   | **Virtual network name** | Enter a name for the virtual network. |
+   | **Region** | Select the region for the virtual network and dev boxes. |
 
-    :::image type="content" source="./media/how-to-manage-network-connection/example-basics-tab.png" alt-text="Screenshot of the Basics tab on the pane for creating a virtual network in the Azure portal." lightbox="./media/how-to-manage-network-connection/example-basics-tab.png":::
+   :::image type="content" source="./media/how-to-manage-network-connection/example-basics-tab.png" border="false"  alt-text="Screenshot of the Basics tab on the pane for creating a virtual network in the Azure portal." lightbox="./media/how-to-manage-network-connection/example-basics-tab.png":::
 
    > [!IMPORTANT]
    > The region you select for the virtual network is where Azure deploys the dev boxes.
 
-1. On the **IP Addresses** tab, accept the default settings.
-
 1. On the **Security** tab, accept the default settings.
 
+1. On the **IP addresses** tab, accept the default settings.
+
 1. On the **Review + create** tab, review the settings.
 
-1. Select **Create**.
+1. After validation passes for your configuration, select **Create**.
+
+This procedure creates a virtual network and a default subnet.
 
 ## Allow access to Microsoft Dev Box endpoints from your network
 
@@ -79,82 +81,85 @@ If your organization routes egress traffic through a firewall, you need to open
 
 ## Plan a network connection
 
-The following sections show you how to create and configure a network connection in Microsoft Dev Box.
+The following sections show how to create and configure a network connection in Microsoft Dev Box.
 
 ### Review types of Active Directory join
 
-Microsoft Dev Box requires a configured and working Active Directory join, which defines how dev boxes join your domain and access resources. There are two choices: Microsoft Entra join and Microsoft Entra hybrid join.
+Microsoft Dev Box requires a configured and working Active Directory join, which defines how dev boxes join your domain and access resources. You have two choices:
 
-- **Microsoft Entra join**. If your organization uses Microsoft Entra ID, you can use a Microsoft Entra join (sometimes called a _native_ Microsoft Entra join). Dev box users sign in to Microsoft Entra joined dev boxes by using their Microsoft Entra account. They access resources based on the permissions assigned to that account. Microsoft Entra join enables access to cloud-based and on-premises apps and resources. For more information, see [Plan your Microsoft Entra join deployment](../active-directory/devices/device-join-plan.md).
+- **Microsoft Entra join**: If your organization uses Microsoft Entra ID, you can use a Microsoft Entra join (sometimes called a _native_ Microsoft Entra join). Dev box users sign in to Microsoft Entra joined dev boxes by using their Microsoft Entra account. They access resources based on the permissions assigned to that account. Microsoft Entra join enables access to cloud-based and on-premises apps and resources. For more information, see [Plan your Microsoft Entra join deployment](../active-directory/devices/device-join-plan.md).
 
-- **Microsoft Entra hybrid join**. If your organization has an on-premises Active Directory implementation, you can still benefit from some of the functionality in Microsoft Entra ID by using Microsoft Entra hybrid joined dev boxes. These dev boxes are joined to your on-premises Active Directory instance and registered with Microsoft Entra ID. Microsoft Entra hybrid joined dev boxes require network line of sight to your on-premises domain controllers periodically. Without this connection, devices become unusable. For more information, see [Plan your Microsoft Entra hybrid join deployment](../active-directory/devices/hybrid-join-plan.md).
+- **Microsoft Entra hybrid join**: If your organization has an on-premises Active Directory implementation, you can still benefit from some of the functionality in Microsoft Entra ID by using Microsoft Entra hybrid joined dev boxes. These dev boxes are joined to your on-premises Active Directory instance and registered with Microsoft Entra ID. Microsoft Entra hybrid joined dev boxes require network line of sight to your on-premises domain controllers periodically. Without this connection, devices become unusable. For more information, see [Plan your Microsoft Entra hybrid join deployment](../active-directory/devices/hybrid-join-plan.md).
 
 ### Create a network connection
+
+Use the following procedures to create a network connection for your dev box configuration.
+
 <a name='azure-ad-join'></a>
 
 # [**Microsoft Entra join**](#tab/AzureADJoin/)
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **network connections**. In the list of results, select **Network Connections**.
+1. In the search box, enter **network connections**. In the list of results, select **Network connections**.
 
-1. On the **Network Connections** page, select **Create**.
+1. On the **Network connections** page, select **+ Create**:
 
-   :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot that shows the Create button on the page for network connections." lightbox="./media/how-to-manage-network-connection/network-connections-empty.png":::
+   :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot that shows how to select Create on the Network connections pane.":::
 
-1. On the **Create a network connection** pane, on the **Basics** tab, enter the following values:
+1. On the **Create a network connection** pane, configure the following values on the **Basics** tab:
 
    | Setting | Value |
    |---|---|
-   | **Domain join type** | Select **Microsoft Entra join**. |
+   | **Domain join type** | Select **Azure active directory join** (for _Microsoft Entra join_). |
    | **Subscription** | Select the subscription in which you want to create the network connection. |
    | **Resource group** | Select an existing resource group, or select **Create new** and then enter a name for the new resource group. |
    | **Name** | Enter a descriptive name for the network connection. |
    | **Virtual network** | Select the virtual network that you want the network connection to use. |
    | **Subnet** | Select the subnet that you want the network connection to use. |
 
-   :::image type="content" source="./media/how-to-manage-network-connection/create-native-network-connection-full-blank.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a network connection, with the option for Microsoft Entra join selected." lightbox="./media/how-to-manage-network-connection/create-native-network-connection-full-blank.png":::
+   :::image type="content" source="./media/how-to-manage-network-connection/create-native-network-connection-full-blank.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a network connection, with the option for Microsoft Entra join selected.":::
 
-1. Select **Review + Create**.
+1. On the **Review + create** tab, review the settings.
 
-1. On the **Review** tab, select **Create**.
+1. After validation passes for your configuration, select **Create**.
 
-1. When the deployment completes, select **Go to resource**. Confirm the connection appears on the **Network Connections** page.
+1. After the deployment completes, select **Go to resource**. Confirm the connection appears on the **Network connections** page.
 
 <a name='hybrid-azure-ad-join'></a>
 
 # [**Microsoft Entra hybrid join**](#tab/HybridAzureADJoin/)
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **network connections**. In the list of results, select **Network Connections**.
+1. In the search box, enter **network connections**. In the list of results, select **Network connections**.
 
-1. On the **Network Connections** page, select **Create**.
+1. On the **Network connections** page, select **+ Create**:
 
-   :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot that shows the Create button on the page that lists network connections." lightbox="./media/how-to-manage-network-connection/network-connections-empty.png":::
+   :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot that shows the Create option highlighted on the Network connections pane.":::
 
-1. On the **Create a network connection** pane, on the **Basics** tab, enter the following values:
+1. On the **Create a network connection** pane, configure the following values on the **Basics** tab:
 
    | Setting | Value |
    |---|---|
-   | **Domain join type** | Select **Microsoft Entra hybrid join**. |
+   | **Domain join type** | Select **Hybrid Azure active directory join** (for _Microsoft Entra hybrid join_). |
    | **Subscription** | Select the subscription in which you want to create the network connection. |
-   | **ResourceGroup** | Select an existing resource group, or select **Create new** and then enter a name for the new resource group. |
+   | **Resource group** | Select an existing resource group, or select **Create new** and then enter a name for the new resource group. |
    | **Name** | Enter a descriptive name for the network connection. |
    | **Virtual network** | Select the virtual network that you want the network connection to use. |
    | **Subnet** | Select the subnet that you want the network connection to use. |
-   | **AD DNS domain name**| Enter the DNS name of the Active Directory domain that you want to use for connecting and provisioning Cloud PCs. For example: `corp.contoso.com`. |
+   | **AD DNS domain name**| Enter the domain name system (DNS) name of the Active Directory domain that you want to use for connecting and provisioning cloud computers, such as `corp.contoso.com`. |
    | **Organizational unit** | Enter the organizational unit (OU). An OU is a container within an Active Directory domain that can hold users, groups, and computers. |
-   | **AD username UPN** | Enter the username, in user principal name (UPN) format, that you want to use for connecting Cloud PCs to your Active Directory domain. For example: `[email protected]`. This service account must have permission to join computers to the domain and the target OU (if one is set). |
+   | **AD username UPN** | Enter the username, in user principal name (UPN) format, that you want to use for connecting cloud computers to your Active Directory domain, such as `[email protected]`. This service account must have permission to join computers to the domain and the target OU (if one is set). |
    | **AD domain password** | Enter the password for the user. |
 
-   :::image type="content" source="./media/how-to-manage-network-connection/create-hybrid-network-connection-full-blank.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a network connection, with the option for Microsoft Entra hybrid join selected." lightbox="./media/how-to-manage-network-connection/create-hybrid-network-connection-full-blank.png":::
+   :::image type="content" source="./media/how-to-manage-network-connection/create-hybrid-network-connection-full-blank.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a network connection, with the option for Microsoft Entra hybrid join selected.":::
 
-1. Select **Review + Create**.
+1. On the **Review + create** tab, review the settings.
 
-1. On the **Review** tab, select **Create**.
+1. After validation passes for your configuration, select **Create**.
 
-1. When the deployment completes, select **Go to resource**. Confirm the connection appears on the **Network connections** page.
+1. After the deployment completes, select **Go to resource**. Confirm the connection appears on the **Network connections** page.
 
 ---
 

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

@@ -1,7 +1,7 @@
 ---
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 01/12/2024
+ms.date: 08/27/2025
 ms.topic: include
 ms.service: dev-box
 ---
@@ -12,41 +12,48 @@ You can attach existing network connections to a dev center. You must attach a n
 
 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:
+Follow these steps 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 the specific dev center that you want to update.
 
-1. Select **+ Add**.
+1. Under **Dev box configuration**, select **Networking**, and then 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/select-add-network-connection.png" alt-text="Screenshot that shows how to select Add to attach a network connection to a dev center.":::
 
-   :::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":::
+1. On the **Add network connection** pane, select the network connection, and then select **Add**:
 
-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/add-network-connection.png" alt-text="Screenshot that shows the pane for selecting the network connection to add.":::
 
-:::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" :::
+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:
 
-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.
+:::image type="content" source="../media/how-to-manage-network-connection/network-connection-grid-populated.png" alt-text="Screenshot that shows the status of the network connections attached to the dev center.":::
+
+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.
+Follow these steps to remove an attached network connection from a dev center.
+
+> [!NOTE]
+> If a network connection is in use by one or more dev centers, the connection can't be removed.
 
 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 dev center that has the connection you want to remove.
+
+1. Under **Dev box configuration**, select **Networking**.
 
-1. Select the network connection that you want to remove, and then select **Remove**.
+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":::
+   :::image type="content" source="../media/how-to-manage-network-connection/remove-network-connection.png" alt-text="Screenshot that shows how to remove a selected network connection attached to a dev center.":::
 
 1. Review the warning message, and then select **OK**.