Skip to content

Commit 438db25

Browse files
committed
Changed dev box defintions to image defintions
1 parent 29827d6 commit 438db25

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

articles/dev-box/how-to-enable-guest-access.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,8 @@ Before you begin, make sure you have the following prerequisites in place:
2929

3030
- An Azure account with an active subscription.
3131
- 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.
3434
- A dev box pool with [single sign-on (SSO) enabled](how-to-enable-single-sign-on.md). SSO is required for guest user access.
3535

3636
## Register for the preview
@@ -61,27 +61,27 @@ Contact your Microsoft support representative to submit your tenant ID and dev c
6161

6262
After Microsoft confirms that your tenant is enabled, you can proceed with the remaining steps.
6363

64-
## Create a dev box definition with a supported image
64+
## Create an image definition with a supported image
6565

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.
6767

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:
6969

7070
| Requirement | Value |
7171
|---|---|
7272
| **Operating system** | Windows 11 Enterprise |
7373
| **Version** | 24H2 or later |
7474
| **Cumulative update** | 2025-09 Cumulative Update for Windows 11 (KB5065789) or later |
7575

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).
7777

7878
## Create a pool with SSO enabled
7979

8080
Guest user access requires single sign-on (SSO) to be enabled on the dev box pool.
8181

8282
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).
8383

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.
8585

8686
After you enable SSO on the pool, new dev boxes created from the pool support guest user access.
8787

@@ -139,7 +139,7 @@ To connect to a dev box in a resource tenant by using the developer portal:
139139
The following limitations apply during the public preview:
140140

141141
- 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.
143143
- SSO must be enabled on the pool.
144144
- Windows App version 2.0.804.0 or later is required for connecting through the Windows App.
145145

@@ -148,13 +148,13 @@ The following limitations apply during the public preview:
148148
| Issue | Resolution |
149149
|---|---|
150150
| 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. |
152152
| 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. |
153153
| 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. |
154154

155155
## Related content
156156

157157
- [Configure access to Microsoft Dev Box projects](how-to-manage-dev-box-access.md)
158158
- [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)
160160
- [Add B2B collaboration users in the Azure portal](/entra/external-id/add-users-administrator)

0 commit comments

Comments
 (0)