Skip to content

Commit 46e4d26

Browse files
committed
edit pass: microsoft-dev-box-docset
1 parent 965b5b1 commit 46e4d26

File tree

2 files changed

+36
-30
lines changed

2 files changed

+36
-30
lines changed

articles/dev-box/overview-what-is-microsoft-dev-box.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Organizations can use Microsoft Dev Box Preview in a range of scenarios.
3535

3636
An organization that has globally distributed development teams can configure Dev Box to enable developers to create their own dev boxes in their closest region. Developers can create dev boxes as needed, without waiting for the IT admin team. Users can access dev boxes from any device and from any operating system.
3737

38-
Dev Box supports developers working on multiple projects. Developers can create and use separate dev boxes for separate workloads, projects, or tasks. Developers can create multiple dev boxes from a predefined pool whenever they need them, and then delete those dev boxes when they're done.
38+
Dev Box supports developers who are working on multiple projects. Developers can create and use separate dev boxes for separate workloads, projects, or tasks. Developers can create multiple dev boxes from a predefined pool whenever they need them, and then delete those dev boxes when they're done.
3939

4040
Organizations can even define dev boxes for various roles on a team. You might configure standard dev boxes with admin rights to give full-time developers greater control, while applying more restricted permissions for contractors.
4141

@@ -52,8 +52,8 @@ Dev Box helps dev infra teams provide the appropriate dev boxes for each user's
5252

5353
Dev Box has the following benefits for IT admins:
5454

55-
- You can manage dev boxes like any other device:
56-
- Dev boxes automatically enroll in Intune. Use the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431) to manage dev boxes just like any other device on your network.
55+
- You can manage dev boxes like any other device on your network:
56+
- Dev boxes automatically enroll in Intune. Use the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431) to manage dev boxes.
5757
- Keep all Windows devices up to date by using expedited quality updates in Intune to deploy zero-day patches across your organization.
5858
- If a dev box is compromised, isolate it while helping users get back up and running on a new dev box.
5959
- Dev Box provides secure access in a secure environment. Access controls in Azure Active Directory (Azure AD) organize access by project or user type:
@@ -78,13 +78,13 @@ Dev Box projects are the point of access for development teams. You assign the D
7878

7979
Dev box pools make your dev box definitions available in projects. Dev box pools are groups of dev box definitions that have similar settings. For example, you can configure an auto-stop schedule on a dev box pool to stop all the dev boxes in the pool at a specified time.
8080

81-
When the configuration of the service is complete, developers can create and manage their dev boxes through the developer portal. They'll have access to only the dev box pools that are associated with projects for which they have the Dev Box User role.
81+
When the configuration of the service is complete, developers can create and manage their dev boxes through the developer portal. They have access to only the dev box pools that are associated with projects for which they have the Dev Box User role.
8282

8383
[!INCLUDE [supported accounts note](./includes/note-supported-accounts.md)]
8484

8585
## Next steps
8686

8787
Start using Microsoft Dev Box Preview:
8888

89-
- [Quickstart: Configure the Microsoft Dev Box Preview service](./quickstart-configure-dev-box-service.md)
89+
- [Quickstart: Configure Microsoft Dev Box Preview](./quickstart-configure-dev-box-service.md)
9090
- [Quickstart: Create a dev box](./quickstart-create-dev-box.md)

articles/dev-box/quickstart-configure-dev-box-service.md

Lines changed: 31 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,15 @@ To complete this quickstart, you need:
2828
- Owner or contributor permissions on an Azure subscription or a specific resource group.
2929
- An existing virtual network and subnet. If you don't have them, [follow these instructions to create them](#create-a-virtual-network-and-subnet).
3030
- Network Contributor permissions on an existing virtual network (owner or contributor), or permission to create a new virtual network and subnet.
31-
- User licenses. To use Dev Box Preview, each user must be licensed for Windows 11 Enterprise or Windows 10 Enterprise, Microsoft Intune, and Azure Active Directory P1. These licenses are available independently and are included in the following subscriptions:
31+
- User licenses. To use Dev Box Preview, each user must be licensed for Windows 11 Enterprise or Windows 10 Enterprise, Microsoft Intune, and Azure Active Directory (Azure AD) P1. These licenses are available independently and are included in the following subscriptions:
3232

3333
- Microsoft 365 F3
3434
- Microsoft 365 E3, Microsoft 365 E5
3535
- Microsoft 365 A3, Microsoft 365 A5
3636
- Microsoft 365 Business Premium
3737
- Microsoft 365 Education Student Use Benefit
3838
- [Azure Hybrid Benefit](https://azure.microsoft.com/pricing/hybrid-benefit/), which allows you to use your Windows licenses on Azure with Dev Box.
39-
- A configured and working Azure Active Directory (Azure AD) join or hybrid Active Directory join:
39+
- A configured and working Azure AD join or hybrid Active Directory join:
4040

4141
- To learn how to join devices directly to Azure AD, see [Plan your Azure Active Directory join deployment](../active-directory/devices/azureadjoin-plan.md).
4242
- To learn how to join your AD DS domain-joined computers to Azure AD from an on-premises Azure Active Directory Domain Services (AD DS) environment, see [Plan your hybrid Azure Active Directory join deployment](../active-directory/devices/hybrid-azuread-join-plan.md).
@@ -48,7 +48,7 @@ Use the following steps to create a dev center so that you can manage your dev b
4848

4949
1. Sign in to the [Azure portal](https://portal.azure.com).
5050

51-
1. In the search box, type **dev centers**, and then select **Dev centers** in the search results.
51+
1. In the search box, enter **dev centers**. In the search results, select **Dev centers**.
5252

5353
:::image type="content" source="./media/quickstart-configure-dev-box-service/discover-dev-centers.png" alt-text="Screenshot that shows the Azure portal with the search box and the result for dev centers.":::
5454

@@ -91,7 +91,7 @@ Network connections determine the region in which dev boxes are deployed. They a
9191

9292
You must have a virtual network and subnet available for your network connection. To create them:
9393

94-
1. In the search box, type **virtual network**, and then select **Virtual Network** in the search results.
94+
1. In the search box, enter **virtual network**. In the search results, select **Virtual Network**.
9595

9696
1. On the **Virtual Network** page, select **Create**.
9797

@@ -114,23 +114,17 @@ You must have a virtual network and subnet available for your network connection
114114

115115
### Create the connection
116116

117-
You now need a network connection to associate the virtual network and subnet with the dev center. To create the connection:
117+
You now need a network connection to associate the virtual network and subnet with the dev center. To create the connection, complete the steps on the relevant tab.
118118

119-
1. In the search box, type **network connections**, and then select **Network connections** in the search results.
119+
#### [Azure AD join](#tab/AzureADJoin/)
120120

121-
1. On the **Network Connections** page, select **+Create**.
121+
1. In the search box, enter **network connections**. In the search results, select **Network connections**.
122122

123-
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-network-connection.png" alt-text="Screenshot that shows the page for network connections and the button for creating a connection.":::
124-
125-
1. Follow the steps on the appropriate tab to create your network connection.
126-
127-
#### [Azure AD join](#tab/AzureADJoin/)
123+
1. On the **Network connections** page, select **Create**.
128124

129-
1. On the **Network Connections** page, select **Create**.
130-
131-
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-network-connection.png" alt-text="Screenshot that shows the Network Connections page with Create highlighted.":::
125+
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-network-connection.png" alt-text="Screenshot that shows the page for network connections and the button for creating a connection.":::
132126

133-
1. On the **Create a network connection** pane, on the **Basics** tab, select or enter the following values:
127+
1. On the **Create a network connection** pane, on the **Basics** tab, enter the following values:
134128

135129
Name|Value|
136130
|----|----|
@@ -143,9 +137,21 @@ You now need a network connection to associate the virtual network and subnet wi
143137

144138
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-nc-native-join.png" alt-text="Screenshot that shows the Basics tab on the page for creating a network connection, including the option for Azure Active Directory join.":::
145139

146-
#### [Hybrid Azure AD join](#tab/HybridAzureADJoin/)
140+
1. Select **Review + Create**.
141+
142+
1. On the **Review** tab, select **Create**.
147143

148-
On the **Create a network connection** page, on the **Basics** tab, enter the following values:
144+
1. When the deployment is complete, select **Go to resource**. The **Network Connection overview** page appears, which confirms that you created the connection.
145+
146+
#### [Hybrid Azure AD join](#tab/HybridAzureADJoin/)
147+
148+
1. In the search box, enter **network connections**. In the search results, select **Network connections**.
149+
150+
1. On the **Network connections** page, select **Create**.
151+
152+
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-network-connection.png" alt-text="Screenshot that shows the page for network connections and the Create button.":::
153+
154+
1. On the **Create a network connection** pane, on the **Basics** tab, enter the following values:
149155

150156
|Name|Value|
151157
|----|----|
@@ -162,19 +168,19 @@ You now need a network connection to associate the virtual network and subnet wi
162168

163169
:::image type="content" source="./media/quickstart-configure-dev-box-service/create-nc-hybrid-join.png" alt-text="Screenshot that shows the Basics tab on the page for creating a network connection, including the option for hybrid Azure Active Directory join.":::
164170

165-
---
166-
167171
1. Select **Review + Create**.
168172

169173
1. On the **Review** tab, select **Create**.
170174

171175
1. When the deployment is complete, select **Go to resource**. The **Network Connection overview** page appears, which confirms that you created the connection.
172176

177+
---
178+
173179
## Attach the network connection to the dev center
174180

175181
To provide network configuration information for dev boxes, you need to associate a network connection with a dev center. Use the following steps to attach the network connection to your dev center:
176182

177-
1. In the search box, type **dev centers**, and then select **Dev centers** in the search results.
183+
1. In the search box, enter **dev centers**. In the search results, select **Dev centers**.
178184

179185
1. Select the dev center that you created, and then select **Networking**.
180186

@@ -218,7 +224,7 @@ Dev box projects enable you to manage team-level settings, including providing a
218224

219225
To create and configure a project in a dev box:
220226

221-
1. In the search box, type **projects**, and then select **Projects** in the search results.
227+
1. In the search box, enter **projects**. In the search results, select **Projects**.
222228

223229
1. On the **Projects** page, select **+Create**.
224230

@@ -250,7 +256,7 @@ A dev box pool is a collection of dev boxes that have similar settings. Dev box
250256

251257
To create a dev box pool that's associated with a project:
252258

253-
1. In the search box, type **projects**, and then select **Projects** in the search results.
259+
1. In the search box, enter **projects**. In the search results, select **Projects**.
254260

255261
1. Open the project in which you want to create the dev box pool.
256262

@@ -291,7 +297,7 @@ Before users can create dev boxes based on the dev box pools in a project, you m
291297

292298
To assign roles:
293299

294-
1. In the search box, type **projects**, and then select **Projects** in the search results.
300+
1. In the search box, enter **projects**. In the search results, select **Projects**.
295301

296302
1. Select the project that you want to provide your team members access to.
297303

@@ -315,7 +321,7 @@ To assign roles:
315321

316322
[!INCLUDE [supported accounts note](./includes/note-supported-accounts.md)]
317323

318-
## Assign project admin role
324+
## Assign the Project Admin role
319325

320326
The Microsoft Dev Box Preview service makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their team, like creating and managing dev box pools. To give users permissions to manage projects, add them to the DevCenter Project Admin role.
321327

0 commit comments

Comments
 (0)