Breadcrumbs

Custom Images

Overview

Custom images let you import and manage operating system images for use in Windows 365. You can add images from different Azure sources: managed images or from an Azure Compute Gallery image.

Choosing an Image Source

  • Managed image: Use this option to import a single managed image from your Azure subscription.

  • Azure Compute Gallery image: Use this option to import an image from an Azure Compute Gallery, where images are organized by definition and version.

Viewing Custom Images

  1. In Windows 365, select Custom Images.

Frame 1968 (1).png
  1. (Optional) In the search box, enter a keyword to filter images. The table describes the information shown for each image:

Column

Description

Tenant

The tenant associated with the image.

Image name

The name of the custom image.

Image version

The version of the image in Major.Minor.Patch format (for example, 1.0.0).

Status

The current state of the image.Possible values:

  • Pending: The image is being processed.

  • Ready: The image is available for use.

  • Failed: The image couldn't be processed.

Operating system

The operating system of the image (e.g., Windows 10 Enterprise).

OS support status

Indicates whether the operating system is currently supported.

Date modified

The date and time when the image was last updated.

Frame 1971.png

Adding a Managed Image

Before you begin, you must have access to the Azure subscription. Windows 365 may be granted the Reader role for the subscription. For details, see the Microsoft documentation.

  1. To the right of the Custom Images table, click “+” and then select image-20260317-111209.png (Add Managed Image).

  2. In Add Managed Image, enter the following:

    1. Tenant: Select a tenant.

    2. Image name: Enter an image name. Allowed: letters (A–Z, a–z), numbers (0–9), and characters (-, _, .)

    3. Image version: Enter an image version. The version must follow Major.Minor.Patch format (for example, 1.0.0). Note that the combination of image name and version must be unique within a tenant.

    4. Subscription: Select a subscription. Note that as part of this process, you grant Windows 365 permissions in your Azure subscription.

    5. Source image: Select a source image. This list includes images in the selected Azure subscription. Images must be generalized from generation 2 VMs running Windows 10 Enterprise or later.

  3. Click Save.

Frame 1972.png

Before you begin, you must have the Compute Gallery Image Reader role. To learn more, see the Microsoft documentation.

  1. To the right of the Custom Images table, click “+” and then select Frame 1969.png (Add Azure Compute Gallery Image).

  2. In Add Azure Compute Gallery Image, enter the following:

    1. Tenant: Select a tenant.

    2. Image name: Enter an image name. Allowed: letters (A–Z, a–z), numbers (0–9), and characters (-, _, .)

    3. Image version: Enter an image version. The version must follow Major.Minor.Patch format (for example, 1.0.0). Note that the combination of image name and version must be unique within a tenant.

    4. Subscription: Select a subscription. Note that you grant Windows 365 permission to access this subscription.

    5. Azure Compute Gallery: Select a gallery. This is the Azure Compute Gallery that includes the image you want to import.

      1. Image definition: Select an image definition. The image definition contains the image version you want to import.

      2. Image version: Select an image version from the gallery. Note that the available versions depend on the selected image definition.

  3. Click Save.

Frame 1973.png

Updating Images

  1. Select one or more images in the table.

  2. Click Update.

Deleting Images

  1. Select one or more images in the table.

  2. Click the Delete (trash) icon.

  3. Confirm the deletion.

The delete option is unavailable until you select at least one image.