Oracle Cloud Infrastructure Documentation

Secure Desktops Tags

Apply tags to desktop images or desktop pools for use with Secure Desktops.

Adding Tags to Desktop Images

Add tags to desktop images for use with Secure Desktops.

To add tags:
  1. Open the navigation menu and select Compute. Under Compute, select Custom Images.
  2. Select the custom image.
  3. Select the Tags tab to view or edit the existing tags. Or select More Actions, and then select Add Tags to add new ones.

The tenancy administrator can apply the following tags:

Tag Key Tag Value Description
oci:desktops:is_desktop_image true Enables the image to be used by Secure Desktops to provision desktops. This tag is required.
oci:desktops:image_os_type Oracle Linux | Windows Specifies the operating system type for the image. This tag is optional.
oci:desktops:image_version <version> Specifies a meaningful image <version> reference. This tag is optional.

Adding Tags to Desktop Pools

Optionally, add tags to desktop pools created in Secure Desktops.

To add tags when creating a desktop pool:
  1. During desktop pool creation, in the Secure Desktops administrator console, select Show tagging options.
  2. Select a Tag Namespace or accept the default (None - add a free-form tag).
  3. Enter a Tag Key and Tag Value.
  4. Select Add tag.
To add tags to an existing desktop pool:
  1. Open the navigation menu and select Compute. Under Secure Desktops, select Desktop Pools.
  2. Under List scope, select the compartment that contains the desktop pool.
  3. Select the desktop pool name.
  4. On the Desktop Pool Details page, do one of the following:
    • Select the Tags tab and then select Add tags.
    • Select More actions and select Add tags.
  5. Select a Tag Namespace or accept the default (None - add a free-form tag).
  6. Enter a Tag Key and Tag Value.
  7. Select Add tag.

The desktop administrator can apply the following tags:

Tag Key Tag Value Description
oci:desktops:dedicated_host_shape <dvh-shape>

Specifies a specific <dvh-shape> to use for your image to create desktops. This tag is optional.

For example, oci:desktops:dedicated_host_shape DVH.Standard2.52 specifies to use the DVH.Standard2.52 shape for the desktop pool and desktops created using this image.
oci:desktops:enable_byol true

Enables the bring your own license (BYOL) license type for the Windows image used to create the desktop pool.

This tag is only required when using the Secure Desktops API or CLI to create a Windows desktop pool with a Windows BYOL image. When using the console, this tag is automatically generated.

Note: This tag is immutable and can only be added during desktop pool creation.
oci:desktops:enable_measured_boot false

Disables Measured Boot, a component of Windows 11 shielded desktop instances. This tag is optional.

Shielded instances are enabled by editing the custom image to select Secure Boot. See Importing a Windows-Based VM. During desktop pool creation, Secure Desktops detects this image setting and automatically enables shielded instances for the desktop pool.

To override this behavior and disable shielded instances for the desktop pool, add both of the following tags when creating the desktop pool:

  • oci:desktops:enable_secure_boot=false
  • oci:desktops:enable_measured_boot=false

Note: These tags are immutable and can only be added during desktop pool creation.

oci:desktops:enable_secure_boot false

Disables Secure Boot, a component of Windows 11 shielded desktop instances. This tag is optional.

Shielded instances are enabled by editing the custom image to select Secure Boot. See Importing a Windows-Based VM. During desktop pool creation, Secure Desktops detects this image setting and automatically enables shielded instances for the desktop pool.

To override this behavior and disable shielded instances for the desktop pool, add both of the following tags when creating the desktop pool:

  • oci:desktops:enable_secure_boot=false
  • oci:desktops:enable_measured_boot=false

Note: These tags are immutable and can only be added during desktop pool creation.

oci:desktops:hostname_prefix <prefix>

Specifies a custom hostname prefix for desktops in a desktop pool. This tag is optional.

For more information, see Setting the Hostname Prefix for a Desktop Pool.
oci:desktops:is_auth false Enables automatic provisioning of the default desktop user account and uses it by default. This is the default value for this tag. This tag is optional.
true

Disables automatic provisioning of the default desktop user account. Instead, defer to the image's authentication scheme.

This tag is optional. Use this tag to specify your own user accounts integrated with Active Directory or another directory service using LDAP. See User Accounts.