Skip to content

Commit e943075

Browse files
authored
Merge pull request #233915 from RoseHJM/MDB-mario-update
Added new information to image requirements
2 parents e111e88 + 50bfa2a commit e943075

File tree

1 file changed

+29
-15
lines changed

1 file changed

+29
-15
lines changed

articles/dev-box/how-to-configure-azure-compute-gallery.md

Lines changed: 29 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -27,24 +27,38 @@ To learn more about Azure Compute Gallery and how to create galleries, see:
2727

2828
## Prerequisites
2929

30-
- A dev center. If you don't have one available, follow the steps in [1. Create a dev center](quickstart-configure-dev-box-service.md#1-create-a-dev-center).
31-
- A compute gallery. For you to use a gallery to configure dev box definitions, it must have at least [one image definition and one image version](../virtual-machines/image-version.md):
32-
- The image version must meet the [Windows 365 image requirements](/windows-365/enterprise/device-images#image-requirements):
33-
- Generation 2.
34-
- Hyper-V v2.
35-
- Windows OS.
36-
- Generalized image.
37-
- Single-session virtual machine (VM) images. (Multiple-session VM images aren't supported.)
38-
- No recovery partition.
39-
- Default 64-GB OS disk size. The OS disk size is automatically adjusted to the size specified in the SKU description of the Windows 365 license.
40-
41-
- The image definition must have [trusted launch enabled as the security type](../virtual-machines/trusted-launch.md). You configure the security type when you create the image definition.
30+
- A dev center. If you don't have one available, follow the steps in [Create a dev center](quickstart-configure-dev-box-service.md#1-create-a-dev-center).
31+
- A compute gallery. Images stored in a compute gallery can be used in a dev box definition, provided they meet the requirements listed in the [Compute gallery image requirements](#compute-gallery-image-requirements) section.
32+
33+
> [!NOTE]
34+
> Microsoft Dev Box Preview doesn't support community galleries.
35+
36+
## Compute gallery image requirements
37+
38+
A gallery used to configure dev box definitions must have at least [one image definition and one image version](../virtual-machines/image-version.md).
39+
40+
The image version must meet the following requirements:
41+
- Generation 2.
42+
- Hyper-V v2.
43+
- Windows OS.
44+
- Windows 10 Enterprise version 20H2 or later.
45+
- Windows 11 Enterprise 21H2 or later.
46+
- Generalized VM image.
47+
- You must create the image using the following sysprep options: `/mode:vm flag: Sysprep /generalize /oobe /mode:vm`. </br>
48+
For more information, see: [Sysprep Command-Line Options](/windows-hardware/manufacture/desktop/sysprep-command-line-options?view=windows-11#modevm&preserve-view=true).
49+
- To speed up the Dev Box creation time, you can disable the reserved storage state feature in the image by using the following command: `DISM.exe /Online /Set-ReservedStorageState /State:Disabled`. </br>
50+
For more information, see: [DISM Storage reserve command-line options](/windows-hardware/manufacture/desktop/dism-storage-reserve?view=windows-11#set-reservedstoragestate&preserve-view=true).
51+
- Single-session virtual machine (VM) images. (Multiple-session VM images aren't supported.)
52+
- No recovery partition.
53+
- For information about how to remove a recovery partition, see the [Windows Server command: delete partition](/windows-server/administration/windows-commands/delete-partition).
54+
- Default 64-GB OS disk size. The OS disk size is automatically adjusted to the size specified in the SKU description of the Windows 365 license.
55+
- The image definition must have [trusted launch enabled as the security type](../virtual-machines/trusted-launch.md). You configure the security type when you create the image definition.
4256

4357
:::image type="content" source="media/how-to-configure-azure-compute-gallery/image-definition.png" alt-text="Screenshot that shows Windows 365 image requirement settings.":::
4458

4559
> [!NOTE]
46-
> - If you have existing images that don't meet the Windows 365 image requirements, those images won't be listed for image creation.
47-
> - Microsoft Dev Box Preview doesn't support community galleries.
60+
> - Dev Box image requirements exceed [Windows 365 image requirements](/windows-365/enterprise/device-images) and include settings to optimize dev box creation time and performance.
61+
> - Images that do not meet Windows 365 requirements will not be listed for creation.
4862
4963
## Provide permissions for services to access a gallery
5064

@@ -106,7 +120,7 @@ Use the following steps to manually assign each role.
106120
| **Assign access to** | Select **Managed Identity**. |
107121
| **Members** | Search for and select the user-assigned managed identity that you created when you [added a user-assigned identity to the dev center](#add-a-user-assigned-identity-to-the-dev-center). |
108122

109-
You can use the same managed identity in multiple dev centers and compute galleries. Any dev center with the managed identity added will have the necessary permissions to the images in the gallery that you've added the Owner role assignment to.
123+
You can use the same managed identity in multiple dev centers and compute galleries. Any dev center with the managed identity added has the necessary permissions to the images in the gallery that you've added the Owner role assignment to.
110124

111125
## Attach a gallery to a dev center
112126

0 commit comments

Comments
 (0)