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/how-to-enable-guest-access.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,8 +29,8 @@ Before you begin, make sure you have the following prerequisites in place:
29
29
30
30
- An Azure account with an active subscription.
31
31
- A [dev center with at least one project](quickstart-configure-dev-box-service.md) configured in Microsoft Dev Box.
32
-
- Permission to invite guest users in your Microsoft Entra tenant. For more information, see [Add B2B collaboration users in the Azure portal](/entra/external-id/add-users-administrator).
33
-
-A dev box definition that uses a **Windows 11 Enterprise, version 24H2 or later** image with the **2025-09 Cumulative Update for Windows 11 (KB5065789)** or later installed. For more information, see [Manage a dev box definition](how-to-manage-dev-box-definitions.md).
32
+
- Permission to [invite guest users](/entra/external-id/add-users-administrator) in your Microsoft Entra tenant.
33
+
-An [image definition](how-to-configure-team-customizations.md) that uses a **Windows 11 Enterprise, version 24H2 or later**base image with the **2025-09 Cumulative Update for Windows 11 (KB5065789)** or later installed.
34
34
- A dev box pool with [single sign-on (SSO) enabled](how-to-enable-single-sign-on.md). SSO is required for guest user access.
35
35
36
36
## Register for the preview
@@ -61,27 +61,27 @@ Contact your Microsoft support representative to submit your tenant ID and dev c
61
61
62
62
After Microsoft confirms that your tenant is enabled, you can proceed with the remaining steps.
63
63
64
-
## Create a dev box definition with a supported image
64
+
## Create an image definition with a supported image
65
65
66
-
Guest user access requires a dev box definition that uses a Windows 11 Enterprise image, version 24H2 or later, with specific cumulative updates installed.
66
+
Guest user access requires an image definition that uses a Windows 11 Enterprise base image, version 24H2 or later, with specific cumulative updates installed.
67
67
68
-
1. Create or update a dev box definition with an image that meets these requirements:
68
+
1. Create or update an image definition with a base image that meets these requirements:
69
69
70
70
| Requirement | Value |
71
71
|---|---|
72
72
|**Operating system**| Windows 11 Enterprise |
73
73
|**Version**| 24H2 or later |
74
74
|**Cumulative update**| 2025-09 Cumulative Update for Windows 11 (KB5065789) or later |
75
75
76
-
1. Verify that the image in your dev box definition includes the required update. You can use a marketplace image that already includes the update, or prepare a custom image. For more information on creating definitions, see [Manage a dev box definition](how-to-manage-dev-box-definitions.md).
76
+
1. Verify that the base image in your image definition includes the required update. You can use a marketplace image that already includes the update, or prepare a custom image. For more information on creating image definitions, see [Configure team customizations](how-to-configure-team-customizations.md).
77
77
78
78
## Create a pool with SSO enabled
79
79
80
80
Guest user access requires single sign-on (SSO) to be enabled on the dev box pool.
81
81
82
82
1. Create a new dev box pool or update an existing pool to enable SSO. For the detailed steps, see [Enable single sign-on for dev boxes](how-to-enable-single-sign-on.md).
83
83
84
-
1. Assign the dev box definition with the supported image to the pool.
84
+
1. Assign the image definition with the supported image to the pool.
85
85
86
86
After you enable SSO on the pool, new dev boxes created from the pool support guest user access.
87
87
@@ -139,7 +139,7 @@ To connect to a dev box in a resource tenant by using the developer portal:
139
139
The following limitations apply during the public preview:
140
140
141
141
- You must register your tenant and dev center with Microsoft before you can use guest user access.
142
-
- The dev box definition must use a Windows 11 Enterprise 24H2 or later image with the 2025-09 Cumulative Update (KB5065789) or later.
142
+
- The image definition must use a Windows 11 Enterprise 24H2 or later base image with the 2025-09 Cumulative Update (KB5065789) or later.
143
143
- SSO must be enabled on the pool.
144
144
- Windows App version 2.0.804.0 or later is required for connecting through the Windows App.
145
145
@@ -148,13 +148,13 @@ The following limitations apply during the public preview:
148
148
| Issue | Resolution |
149
149
|---|---|
150
150
| Dev box doesn't appear in the developer portal or Windows App after creation. | Wait up to 30 minutes for the dev box to become visible. |
151
-
| Can't connect to the dev box. | Verify that SSO is enabled on the pool and that the dev box definition uses a supported image. |
151
+
| Can't connect to the dev box. | Verify that SSO is enabled on the pool and that the image definition uses a supported base image. |
152
152
| Sign-in fails in Windows App. | Make sure you're using Windows App version 2.0.804.0 or later. Use the **Sign in to an organization** flow and enter the correct domain name. |
153
153
| Guest user can't see the project or pools. | Confirm the user was invited as a guest in the tenant and assigned the **DevCenter Dev Box User** role at the project level. |
154
154
155
155
## Related content
156
156
157
157
-[Configure access to Microsoft Dev Box projects](how-to-manage-dev-box-access.md)
158
158
-[Enable single sign-on for dev boxes](how-to-enable-single-sign-on.md)
159
-
-[Manage a dev box definition](how-to-manage-dev-box-definitions.md)
159
+
-[Configure team customizations](how-to-configure-team-customizations.md)
160
160
-[Add B2B collaboration users in the Azure portal](/entra/external-id/add-users-administrator)
0 commit comments