You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/dev-box/quickstart-create-dev-box.md
+21-15Lines changed: 21 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,12 +7,13 @@ ms.service: dev-box
7
7
ms.topic: quickstart
8
8
author: RoseHJM
9
9
ms.author: rosemalcolm
10
-
ms.date: 09/12/2023
10
+
ms.date: 12/13/2023
11
11
#Customer intent: As a dev box user, I want to understand how to create and access a dev box so that I can start work.
12
12
---
13
13
14
14
# Quickstart: Create and connect to a dev box by using the Microsoft Dev Box developer portal
15
15
16
+
16
17
In this quickstart, you get started with Microsoft Dev Box by creating a dev box through the developer portal. After you create the dev box, you can connect to it with a Remote Desktop session through a browser or through a Remote Desktop app.
17
18
18
19
You can create and manage multiple dev boxes as a dev box user. Create a dev box for each task that you're working on, and create multiple dev boxes within a single project to help streamline your workflow. For example, you might switch to another dev box to fix a bug in a previous version, or if you need to work on a different part of the application.
@@ -33,36 +34,41 @@ To create a dev box in the Microsoft Dev Box developer portal:
33
34
34
35
1. Sign in to the [Microsoft Dev Box developer portal](https://aka.ms/devbox-portal).
35
36
36
-
2. Select **Get started**.
37
+
1. Select **Add a dev box**.
37
38
38
39
:::image type="content" source="./media/quickstart-create-dev-box/welcome-to-developer-portal.png" alt-text="Screenshot of the developer portal and the button for adding a dev box.":::
39
40
40
-
3. In **Add a dev box**, enter the following values:
41
+
1. In **Add a dev box**, enter the following values:
41
42
42
-
|Name|Value|
43
-
|----|----|
44
-
|**Name**|Enter a name for your dev box. Dev box names must be unique within a project.|
45
-
|**Project**|Select a project from the dropdown list. |
46
-
|**Dev box pool**|Select a pool from the dropdown list, which includes all the dev box pools for that project. |
43
+
| Setting |Value|
44
+
|---|---|
45
+
|**Name**|Enter a name for your dev box. Dev box names must be unique within a project.|
46
+
|**Project**|Select a project from the dropdown list. |
47
+
|**Dev box pool**|Select a pool from the dropdown list, which includes all the dev box pools for that project. |
47
48
48
49
:::image type="content" source="./media/quickstart-create-dev-box/create-dev-box.png" alt-text="Screenshot of the dialog for adding a dev box.":::
49
50
50
-
You see the following information:
51
-
- How many dev boxes you can create in the project that you selected, if the project has limits configured.
52
-
- Whether hibernation is supported or not.
53
-
- A shutdown time if the pool where you're creating the dev box has a shutdown schedule.
51
+
After you make your selections, the page shows you the following information:
52
+
53
+
- How many dev boxes you can create in the project that you selected, if the project has limits configured
54
+
- Whether hibernation is supported or not
55
+
- A shutdown time if the pool where you're creating the dev box has a shutdown schedule
56
+
- A notification that the dev box creation process can take 25 minutes or longer
57
+
58
+
1. Select **Create** to begin creating your dev box.
54
59
55
-
4. Select **Create**to begin creating your dev box.
60
+
1. Use the dev box tile in the developer portal to track the progress of creation.
56
61
57
-
5. Use the dev box tile in the developer portal to track the progress of creation.
62
+
58
63
59
64
:::image type="content" source="./media/quickstart-create-dev-box/dev-box-tile-creating.png" alt-text="Screenshot of the developer portal that shows the dev box card with a status of Creating.":::
60
65
66
+
61
67
[!INCLUDE [dev box runs on creation note](./includes/note-dev-box-runs-on-creation.md)]
62
68
63
69
## Connect to a dev box
64
70
65
-
After you create a dev box, you can connect remotely to the developer VM. Microsoft Dev Box supports connecting to a dev box in the following ways:
71
+
After you create a dev box, you can connect remotely to the developer virtual machine. Microsoft Dev Box supports connecting to a dev box in the following ways:
66
72
67
73
- Connect through the browser from within the developer portal
68
74
- Connect by using a remote desktop client application
0 commit comments