Merge pull request #261710 from GitHubber17/183368-7

Freshness | Microsoft Dev Box procedures

Author: v-regandowner

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

@@ -6,7 +6,7 @@ services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 04/25/2023
+ms.date: 12/20/2023
 ms.topic: how-to
 ---
 
@@ -16,12 +16,12 @@ In this article, you learn how to configure and attach an Azure compute gallery
 
 Azure Compute Gallery is a service for managing and sharing images. A gallery is a repository that's stored in your Azure subscription and helps you build structure and organization around your image resources.
 
-After you attach a compute gallery to a dev center in Microsoft Dev Box, you can create dev box definition based on images stored in the compute gallery.
+After you attach a compute gallery to a dev center in Microsoft Dev Box, you can create dev box definitions based on images stored in the compute gallery.
 
 Advantages of using a gallery include:
 
 - You maintain the images in a single location and use them across dev centers, projects, and pools.
-- Development teams can use the latest version of an image definition to ensure that they always receive the most recent image when creating dev boxes.
+- Development teams can use the latest version of an image definition to ensure they always receive the most recent image when creating dev boxes.
 - Development teams can standardize on a supported image version until a newer version is validated.
 
 To learn more about Azure Compute Gallery and how to create galleries, see:
@@ -41,49 +41,53 @@ To learn more about Azure Compute Gallery and how to create galleries, see:
 
 A gallery used to configure dev box definitions must have at least [one image definition and one image version](../virtual-machines/image-version.md).
 
-When you create a virtual machine image, select an image from the Azure Marketplace that is compatible with Microsoft Dev Box. The following are examples of compatible images:
+When you create a virtual machine (VM) image, select an image from the Azure Marketplace that's compatible with Microsoft Dev Box. The following are examples of compatible images:
 - [Visual Studio 2019](https://azuremarketplace.microsoft.com/marketplace/apps/microsoftvisualstudio.visualstudio2019plustools?tab=Overview)
 - [Visual Studio 2022](https://azuremarketplace.microsoft.com/marketplace/apps/microsoftvisualstudio.visualstudioplustools?tab=Overview) 
 
 The image version must meet the following requirements:
-- Generation 2.
-- Hyper-V v2.
-- Windows OS.
-    - Windows 10 Enterprise version 20H2 or later.
-    - Windows 11 Enterprise 21H2 or later.
-- Generalized VM image.
-    - You must create the image using these three sysprep options: `/generalize /oobe /mode:vm`. </br>
-      For more information, see: [Sysprep Command-Line Options](/windows-hardware/manufacture/desktop/sysprep-command-line-options?view=windows-11#modevm&preserve-view=true).
-    - To speed up the Dev Box creation time:
-      - Disable the reserved storage state feature in the image by using the following command: `DISM.exe /Online /Set-ReservedStorageState /State:Disabled`. </br>
-        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).
-      -	Run `defrag` and `chkdsk` during image creation, wait for them to finish. And disable `chkdisk` and `defrag` scheduled task.
-- Single-session virtual machine (VM) images. (Multiple-session VM images aren't supported.)
-- No recovery partition.
-    - For information about how to remove a recovery partition, see the [Windows Server command: delete partition](/windows-server/administration/windows-commands/delete-partition).
-- 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.
+- Generation 2
+- Hyper-V v2
+- Windows OS
+   - Windows 10 Enterprise version 20H2 or later
+   - Windows 11 Enterprise 21H2 or later
+- Generalized VM image
+   - You must create the image by using these three sysprep options: `/generalize /oobe /mode:vm`. For more information, see [Sysprep Command-Line Options](/windows-hardware/manufacture/desktop/sysprep-command-line-options?view=windows-11#modevm&preserve-view=true).
+   - To speed up the dev box creation time:
+      - Disable the reserved storage state feature in the image by using the following command: `DISM.exe /Online /Set-ReservedStorageState /State:Disabled`. 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).
+      - Run `defrag` and `chkdsk` during image creation, wait for them to finish. And disable `chkdisk` and `defrag` scheduled task.
+- Single-session VM images (Multiple-session VM images aren't supported.)
+- No recovery partition
+   For information about how to remove a recovery partition, see the [Windows Server command: delete partition](/windows-server/administration/windows-commands/delete-partition).
+- 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.
 - 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.
 
-    :::image type="content" source="media/how-to-configure-azure-compute-gallery/image-definition.png" alt-text="Screenshot that shows Windows 365 image requirement settings.":::
+   :::image type="content" source="media/how-to-configure-azure-compute-gallery/image-definition.png" alt-text="Screenshot that shows Windows 365 image requirement settings.":::
 
 > [!NOTE]
 > - Microsoft 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. 
-> - Images that do not meet Windows 365 requirements will not be listed for creation.
+> - Any image that doesn't meet Windows 365 requirements isn't shown in the list of images that are available for creation.
 
 ## Provide permissions for services to access a gallery
 
-When you use an Azure Compute Gallery image to create a dev box definition, the Windows 365 service validates the image to ensure that it meets the requirements to be provisioned for a dev box. Microsoft Dev Box replicates the image to the regions specified in the attached network connections, so the images are present in the region that's required for dev box creation.
+When you use an Azure Compute Gallery image to create a dev box definition, the Windows 365 service validates the image to ensure that it meets the requirements to be provisioned for a dev box. Microsoft Dev Box replicates the image to the regions specified in the attached network connections, so the images are present in the region required for dev box creation.
 
 To allow the services to perform these actions, you must provide permissions to your gallery as follows.
 
 ### Add a user-assigned identity to the dev center
 
-1. [Follow the steps to create a user-assigned managed identity](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md?pivots=identity-mi-methods-azp#create-a-user-assigned-managed-identity). 
+1. [Follow the steps to create a user-assigned managed identity](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md?pivots=identity-mi-methods-azp#create-a-user-assigned-managed-identity).
+
 1. Sign in to the [Azure portal](https://portal.azure.com).
+
 1. In the search box, enter **dev box**. In the list of results, select **Dev centers**.
+
 1. Open your dev center. On the left menu, select **Identity**.
+
 1. On the **User assigned** tab, select **+ Add**.
-1. In **Add user assigned managed identity**, select the user-assigned managed identity that you created in step 1, and then select **Add**.
+
+1. In the **Add user assigned managed identity** pane, select the user-assigned managed identity that you created in step 1, and then select **Add**.
 
    :::image type="content" source="media/how-to-configure-azure-compute-gallery/assign-managed-id.png" alt-text="Screenshot that shows the pane for adding a user-assigned managed identity.":::
 
@@ -130,60 +134,60 @@ Use the following steps to manually assign each role.
    | **Assign access to** | Select **Managed Identity**. |
    | **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). |
 
-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.
+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 has the Owner role assignment added.
 
 ## Attach a gallery to a dev center
 
 To use the images from a compute gallery in dev box definitions, you must first associate the gallery with the dev center by attaching it:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-2. In the search box, enter **dev box**. In the list of results, select **Dev centers**.
+1. In the search box, enter **dev box**. In the list of results, select **Dev centers**.
 
-3. Select the dev center that you want to attach the gallery to.
+1. Select the dev center that you want to attach the gallery to.
 
-   :::image type="content" source="media/how-to-configure-azure-compute-gallery/devcenter-grid.png" alt-text="Screenshot that shows a list of existing dev centers.":::
+   :::image type="content" source="media/how-to-configure-azure-compute-gallery/devcenter-grid.png" alt-text="Screenshot that shows a list of existing dev centers." lightbox="media/how-to-configure-azure-compute-gallery/devcenter-grid.png":::
 
-4. On the left menu, select **Azure compute galleries** to list the galleries that are attached to this dev center.
+1. On the left menu, select **Azure compute galleries** to list the galleries that are attached to this dev center.
 
-   :::image type="content" source="media/how-to-configure-azure-compute-gallery/gallery-grid-empty.png" alt-text="Screenshot that shows the page for compute galleries, with no galleries listed.":::
+   :::image type="content" source="media/how-to-configure-azure-compute-gallery/gallery-grid-empty.png" alt-text="Screenshot that shows the page for compute galleries, with no galleries listed." lightbox="media/how-to-configure-azure-compute-gallery/gallery-grid-empty.png":::
 
-5. Select **+ Add** to select a gallery to attach.
+1. Select **+ Add** to select a gallery to attach.
 
-6. In **Add Azure compute gallery**, select your gallery. If you have access to more than one gallery that has the same name, the subscription name appears in parentheses.
+1. In **Add Azure compute gallery**, select your gallery. If you have access to more than one gallery that has the same name, the subscription name appears in parentheses.
 
    :::image type="content" source="media/how-to-configure-azure-compute-gallery/gallery-add.png" alt-text="Screenshot that shows the area for selecting a gallery.":::
 
-7. If there's a name conflict in the dev center, you must provide a unique name to use for this gallery.
+1. If there's a name conflict in the dev center, you must provide a unique name to use for this gallery.
 
-8. Select **Add**.
+1. Select **Add**.
 
-9. Confirm that your gallery now appears on the **Azure compute galleries** page.
+1. Confirm your gallery now appears on the **Azure compute galleries** page.
 
    :::image type="content" source="media/how-to-configure-azure-compute-gallery/gallery-grid.png" alt-text="Screenshot that shows the page for compute galleries page with example galleries listed.":::
 
-After you successfully add a gallery, the images in it will be available to select from when you're creating and updating dev box definitions.
+After you successfully add a gallery, the images in the gallery are available to select when you create and update dev box definitions.
 
 ## Remove a gallery from a dev center
 
-You can detach galleries from dev centers so that their images can no longer be used to create dev box definitions.
+You can detach galleries from dev centers so their images can no longer be used to create dev box definitions.
 
 > [!NOTE]
 > You can't remove galleries that are being actively used in dev box definitions. Before you can remove such a gallery, you must delete the associated dev box definition or update the definition to use an image from a different gallery.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-2. In the search box, enter **dev box**. In the list of results, select **Dev centers**.
+1. In the search box, enter **dev box**. In the list of results, select **Dev centers**.
 
-3. Select the dev center that you want to remove the gallery from.
+1. Select the dev center that you want to remove the gallery from.
 
-4. On the left menu, select **Azure compute galleries** to list the galleries that are attached to this dev center.
+1. On the left menu, select **Azure compute galleries** to list the galleries that are attached to this dev center.
 
-5. Select the gallery that you want to remove, and then select **Remove**.
+1. Select the gallery that you want to remove, and then select **Remove**.
 
-   :::image type="content" source="media/how-to-configure-azure-compute-gallery/remove-gallery-from-devcenter.png" alt-text="Screenshot that shows the page for compute galleries, a selected gallery, and the Remove button.":::
+   :::image type="content" source="media/how-to-configure-azure-compute-gallery/remove-gallery-from-devcenter.png" alt-text="Screenshot that shows the page for compute galleries, a selected gallery, and the Remove button." lightbox="media/how-to-configure-azure-compute-gallery/remove-gallery-from-devcenter.png":::
 
-6. In the confirmation dialog, select **Continue**.
+1. In the confirmation dialog, select **Continue**.
 
 The gallery is detached from the dev center. The gallery and its images aren't deleted, and you can reattach it if necessary.