Documentación de productos
Citrix DaaS™
Ver PDF

Crear un catálogo de instancias administradas de Amazon WorkSpaces Core

March 25, 2026
Contribución de: 
C

Crear catálogos de máquinas describe los asistentes que crean un catálogo de máquinas. La siguiente información cubre detalles específicos de las instancias administradas de Amazon WorkSpaces Core.

Nota:

Actualmente, se admite la creación de catálogos de máquinas virtuales persistentes y no persistentes (la propiedad CleanOnBoot es True o False).

Requisitos previos

Antes de crear un catálogo de instancias administradas de Amazon WorkSpaces Core, debes terminar de crear:

  1. Una conexión a las instancias administradas de Amazon WorkSpaces Core. Consulta Conexión a las instancias administradas de Amazon WorkSpaces Core.
  2. Una imagen preparada. Consulta Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core.

Configuración de red durante la preparación de la imagen

Durante la preparación de la imagen, se crea una máquina virtual (VM) de preparación basada en la máquina virtual original. Esta máquina virtual de preparación se desconecta de la red. Para desconectar la red de la máquina virtual de preparación, se crea un grupo de seguridad de red para denegar todo el tráfico entrante y saliente. Este grupo de seguridad de red persiste y se reutiliza. El nombre del grupo de seguridad de red es Citrix.XenDesktop.IsolationGroup-GUID, donde GUID se genera aleatoriamente.

Un catálogo de máquinas basado en un perfil de máquina

Puedes usar un perfil de máquina para capturar las propiedades de hardware de una instancia EC2 (VM) o una versión de plantilla de lanzamiento y aplicarlas a las máquinas aprovisionadas. Las propiedades que se capturan pueden incluir, por ejemplo, el tipo de tenencia, el tipo de instancia, los grupos de seguridad, las asignaciones de red, las propiedades de volumen de EBS, la optimización de EBS, las opciones de CPU, la capacidad de hibernación y otras configuraciones de AWS compatibles.

Puedes usar una instancia EC2 de AWS (VM) o una versión de plantilla de lanzamiento de AWS como entrada del perfil de máquina.

Nota:

Tenencia de AWS

AWS ofrece las siguientes opciones de tenencia: tenencia compartida (el tipo predeterminado) y tenencia dedicada. La tenencia compartida significa que varias instancias de Amazon WorkSpaces Core de diferentes clientes pueden residir en el mismo hardware físico. La tenencia dedicada significa que tus instancias de Amazon WorkSpaces Core se ejecutan solo en hardware con otras instancias que hayas implementado.

Nota:

Solo se admiten las instancias dedicadas (los hosts dedicados no se admiten actualmente). Otros clientes no usan la misma pieza de hardware.

El tipo de tenencia se captura del perfil de máquina

Cuando usas MCS para crear un catálogo para aprovisionar máquinas en AWS, el tipo de tenencia se captura del perfil de máquina.

  • Hardware compartido: Esta configuración es adecuada para la mayoría de las implementaciones. Varios clientes comparten piezas de hardware, aunque no interactúen entre sí. Usar hardware compartido es la opción menos costosa para ejecutar tus instancias de Amazon EC2.
  • Instancia dedicada: Esta configuración es más adecuada para implementaciones con requisitos específicos de seguridad o cumplimiento. Con una instancia dedicada, sigues disfrutando de los beneficios de tener un host separado de otros clientes de AWS, pero no pagas por todo el host. No necesitas preocuparte por la capacidad del host, pero se te cobra una tarifa más alta por las instancias. Además, las instancias dedicadas ofrecen soporte limitado para Bring Your Own License (BYOL).

Se requiere una imagen preparada y un perfil de máquina para crear catálogos de instancias administradas de Amazon WorkSpaces Core. Puedes usar una instancia de máquina virtual de AWS o una versión de plantilla de lanzamiento de AWS como entrada del perfil de máquina.

Puedes crear un catálogo usando:

Crear un catálogo mediante Studio

Crear un catálogo de máquinas desde el nodo Imágenes

Usa la opción Crear catálogo en el nodo Imágenes para crear un catálogo usando la versión de la imagen.

Alternativamente, puedes seleccionar la versión al crear un catálogo en el nodo Catálogos de máquinas, vinculando a la opción de imagen preparada en el flujo de trabajo de creación del catálogo. Consulta Crear un catálogo de máquinas desde el nodo Catálogos de máquinas.

Para crear un catálogo de máquinas MCS desde el nodo Imágenes, haz lo siguiente:

  1. Selecciona una versión de imagen y haz clic en Crear catálogo. Haz clic en Siguiente en la página Introducción.
  2. En las páginas Administración de máquinas e Imagen, la configuración se preselecciona según la versión de imagen seleccionada. En la página Imagen, introduce una nota para la imagen preparada seleccionada.
  3. Completa la configuración en las siguientes páginas.
  4. En la página Resumen, comprueba los detalles del catálogo de máquinas. Introduce un nombre y una descripción para el catálogo de máquinas. Haz clic en Finalizar.
  5. Ve al nodo Catálogos de máquinas para ver el catálogo de máquinas creado.

Crear un catálogo de máquinas desde el nodo Catálogos de máquinas

Para crear un catálogo de máquinas MCS desde el nodo Catálogos de máquinas, haz lo siguiente:

  1. Haz clic en Catálogos de máquinas en el panel de navegación izquierdo.
  2. Haz clic en Crear catálogo de máquinas. Aparece la página Configuración del catálogo de máquinas.
  3. En la página Tipo de máquina, selecciona un tipo de máquina para el catálogo, por ejemplo, SO multisesión.

  4. En la página Administración de máquinas, selecciona la siguiente configuración:

    1. Selecciona Máquinas con administración de energía (por ejemplo, máquinas virtuales o PC blade).
    2. Selecciona Tecnología de aprovisionamiento de Citrix. Luego, selecciona Citrix Machine Creation Services™.
    3. En el campo Recursos, selecciona los recursos (Zona de disponibilidad o Zona local) que configuraste al crear la conexión de host y haz clic en Siguiente.
  5. En la página Experiencia de escritorio, selecciona el escritorio aleatorio o estático que quieres que tengan los usuarios cuando inicien sesión. Si se selecciona un escritorio estático, especifica además si quieres guardar los cambios que el usuario realice en el disco local (persistente o no persistente).

  6. En la página Imagen, haz clic en Seleccionar una imagen para seleccionar una imagen preparada para el catálogo de máquinas. Selecciona la versión preparada que creaste. Haz clic en el nombre de la versión de la imagen. Para ver más detalles sobre la versión de imagen seleccionada, haz clic en el número de versión, que está subrayado. Haz clic en Listo.

    Aparece el perfil de máquina asociado a la imagen preparada y sus propiedades de hardware (por ejemplo, tipo de instancia, tipo de tenencia, asignaciones de red, grupos de seguridad, propiedades de volumen) se usan para crear máquinas en los catálogos. Para cambiar el origen del perfil de máquina a otra máquina virtual o versión de plantilla de lanzamiento, haz clic en el botón de modificar.

  7. En la página Máquinas virtuales:

    1. Introduce el número de máquinas virtuales para el catálogo.
    2. Se muestra la especificación de máquina predeterminada, que se basa en el perfil de máquina. Para cambiarla, selecciona el icono de modificar y selecciona una especificación de máquina.
  8. En la página NIC, selecciona las NIC (o ENI) para las máquinas virtuales.

  9. En la página Identidades de máquina, configura el tipo de identidad de máquina para las máquinas del catálogo:

    1. Para configurar máquinas unidas a un dominio (Active Directory local o unidas a Microsoft Entra híbrido), selecciona el dominio y crea nuevas cuentas de AD para las máquinas virtuales que se crearán en este catálogo de máquinas. Las máquinas virtuales aprovisionadas se unen al dominio seleccionado. Para aprovisionar máquinas no unidas a un dominio, selecciona la opción de no unirse a un dominio.
    2. Especifica el esquema de nombres de cuenta para las nuevas cuentas que se crearán para las máquinas virtuales.
  10. En la página Credenciales de dominio, haz clic en Introducir credenciales para proporcionar las credenciales del dominio seleccionado. Introduce el nombre de usuario y la contraseña de nivel de administrador cuando se te solicite. También puedes usar una cuenta de servicio si ya tienes credenciales de dominio guardadas previamente siguiendo nuestra documentación del producto.
  11. Haz clic para avanzar por las páginas restantes hasta la página de Resumen. Introduce un nombre para el catálogo de máquinas y selecciona Finalizar para crear el catálogo de máquinas.

Limitaciones al crear un catálogo de máquinas en una zona local de AWS

  • Algunas zonas locales solo admiten ciertas configuraciones de hardware (por ejemplo, la zona local de Perth no admite volúmenes GP3, solo GP2).
  • Dado que solo gp2 es compatible universalmente en todas las zonas locales, y no todas admiten gp3, la creación de discos de ID utiliza por defecto el tipo de volumen gp2.
  • Debes seleccionar un perfil de máquina con especificaciones de hardware compatibles con la zona local deseada.
  • Las instantáneas de AMI de imágenes preparadas y las instantáneas de discos de ID se colocan por defecto en la región, en lugar de en la zona local (debido a las limitaciones de AWS con respecto a la visibilidad del soporte de instantáneas de EBS en zonas locales).
  • Solo las zonas locales que admiten servicios completos de EC2 y EBS son zonas compatibles.

Crear un catálogo con PowerShell

Crear un catálogo con una especificación de versión de imagen preparada y un perfil de máquina

  • Crea un catálogo de máquinas no persistentes de MCS a partir de la especificación de versión de imagen preparada mediante el comando New-ProvScheme. Por ejemplo:

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

  • Crea un catálogo de máquinas persistentes de MCS a partir de la especificación de versión de imagen preparada mediante el comando New-ProvScheme. Por ejemplo:

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] 
 <!--NeedCopy-->

Ejemplo del conjunto completo de comandos de Powershell para crear un catálogo:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "wsccatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "wsccatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName wsccatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName wsc -IdentityPoolName wsccatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName wsccatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Actualizar el perfil de máquina

Para actualizar el perfil de máquina en un catálogo que se aprovisionó inicialmente con un perfil de máquina, haz lo siguiente. También puedes cambiar el tipo de tenencia y la capacidad de hibernación del origen del perfil de máquina al modificar un catálogo de máquinas de MCS.

  1. Ejecuta el comando Set-ProvScheme. Por ejemplo:

    Set-ProvScheme `
-ProvisioningSchemeUid "<ID" `
-MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
<!--NeedCopy-->

Crear un catálogo con una versión de plantilla de lanzamiento mediante PowerShell

Puedes crear un catálogo de máquinas de MCS con una versión de plantilla de lanzamiento como entrada de perfil de máquina. También puedes actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de lanzamiento y de una versión de plantilla de lanzamiento a una VM.

En la consola de AWS EC2, puedes proporcionar la información de configuración de instancia de una plantilla de lanzamiento junto con el número de versión. Cuando especificas la versión de la plantilla de lanzamiento como entrada de perfil de máquina al crear o actualizar un catálogo de máquinas, las propiedades de esa versión de la plantilla de lanzamiento se copian en las VM VDA aprovisionadas.

Las siguientes propiedades se pueden proporcionar mediante la entrada del perfil de máquina o explícitamente como parámetros en los comandos New-ProvScheme o Set-ProvScheme. Si se proporcionan en los comandos New-ProvScheme o Set-ProvScheme, tienen prioridad sobre los valores del perfil de máquina de estas propiedades.

  • Oferta de servicio
  • Redes

Nota:

Si la oferta de servicio no se proporciona en la plantilla de lanzamiento del perfil de máquina o como parámetro en el comando New-ProvScheme, recibirás un error apropiado.

Para crear un catálogo con una versión de plantilla de lanzamiento como entrada de perfil de máquina:

  1. Abre una ventana de PowerShell.
  2. Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

  3. Obtén la lista de versiones de plantilla de lanzamiento de una plantilla de lanzamiento. Por ejemplo:

    XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
<!--NeedCopy-->

  4. Crea un grupo de identidades si no está creado. Por ejemplo:

    New-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numeric `
-Domain "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

  5. Crea un esquema de aprovisionamiento con una versión de plantilla de lanzamiento como entrada de perfil de máquina. Por ejemplo:

    New-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
-IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-ImageVersionSpecUid ‘24dfb047-e867-527g-896c-25664xxxxx1t’ ` 
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

  6. Registra un esquema de aprovisionamiento como catálogo de intermediario. Por ejemplo:

    New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->
  7. Completa la creación del catálogo.

Actualizar el origen del perfil de máquina

También puedes actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de lanzamiento y de una versión de plantilla de lanzamiento a una VM. Por ejemplo:

  • Para actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de lanzamiento:

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

  • Para actualizar la entrada de un catálogo de perfiles de máquina de una versión de plantilla de lanzamiento a una VM:

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
 <!--NeedCopy-->

Cifrar discos de SO y de identidad

Puedes crear un catálogo de VM con claves de AWS KMS (clave administrada por el cliente y clave administrada por AWS) que se pueden usar para cifrar el disco del sistema operativo y el disco de identidad (ID).

  • Las claves administradas por AWS se rotan automáticamente cada año.
  • Las claves administradas por el cliente son opcionales para la rotación automática y se pueden administrar manualmente.

Puedes consultar los siguientes documentos de AWS para obtener más información sobre las claves KMS:

Para cifrar los discos del sistema operativo y de identidad, configura una de las siguientes opciones:

  • Usa una imagen preparada que esté cifrada (por ejemplo, una AMI creada a partir de una instancia o instantánea que contenga un volumen raíz de EBS cifrado con una clave KMS)
  • Usa un origen de perfil de máquina (máquina virtual o plantilla de lanzamiento) que contenga un volumen raíz de EBS cifrado.

Limitaciones

Considera las siguientes limitaciones:

  • Actualmente, MCS solo admite un disco en la AMI de imagen preparada.

  • No puedes cifrar directamente volúmenes o instantáneas de EBS existentes sin cifrar, ni modificar la clave KMS de un volumen cifrado existente. Para ello, debes:

    1. Crear una nueva instantánea de ese volumen.
    2. Crear un nuevo volumen a partir de esa instantánea.
    3. Cifrar el nuevo volumen.

Consulta los siguientes documentos de AWS:

Crea un catálogo con cifrado de disco

Puedes crear un catálogo de máquinas MCS con cifrado de disco usando:

  • Una imagen preparada (creada mediante la administración de imágenes a partir de una imagen maestra que tiene un disco cifrado)
  • Un perfil de máquina

Consideraciones al usar la entrada del perfil de máquina:

  • La clave KMS de la entrada del perfil de máquina tiene prioridad sobre la clave KMS de la imagen preparada.
  • Si no se proporciona ninguna entrada de perfil de máquina, la clave KMS de la AMI de imagen preparada se usa para cifrar los discos de las máquinas virtuales del catálogo.
  • Si el perfil de máquina tiene asignaciones de dispositivos de bloque presentes, los dispositivos de bloque presentes en la plantilla de imagen preparada (AMI) y el perfil de máquina deben coincidir. Por ejemplo, si la AMI tiene un dispositivo definido en /dev/sda1, el perfil de máquina también debe tener un dispositivo definido en /dev/sda1.
  • Si no hay ninguna clave en el origen del perfil de máquina y la imagen preparada no está cifrada, los discos de las máquinas virtuales del catálogo no se cifran.
  • Cuando la imagen preparada está cifrada, una máquina virtual de origen de perfil de máquina o una plantilla de lanzamiento debe tener un volumen raíz cifrado para considerarse una entrada válida.

Modifica un catálogo existente

Puedes modificar un catálogo existente usando el comando de PowerShell Set-ProvScheme para tener:

  • Una entrada de perfil de máquina con un volumen que contenga una nueva clave KMS.
  • Una imagen preparada creada a partir de la imagen maestra con AMI cifrada mediante la administración de imágenes.

Consideraciones importantes:

  • Los volúmenes de las nuevas máquinas virtuales agregadas al catálogo se cifran con la nueva clave KMS.
  • Para actualizar la configuración de cifrado cuando hay un perfil de máquina existente, ejecuta Set-ProvScheme con un nuevo perfil de máquina.
  • No puedes modificar un catálogo existente para pasar de tener volúmenes cifrados a volúmenes sin cifrar.
  • No puedes realizar una actualización de imagen de una AMI de imagen preparada cifrada a una AMI de imagen preparada sin cifrar.

Habilita NitroTPM y el arranque seguro UEFI para instancias de máquinas virtuales

Al crear un catálogo, ahora puedes seleccionar una imagen preparada (AMI) con NitroTPM y/o arranque seguro UEFI habilitados. En consecuencia, las máquinas virtuales aprovisionadas en el catálogo también se habilitan con NitroTPM y/o arranque seguro UEFI. Esta implementación garantiza que las máquinas virtuales estén protegidas y sean de confianza. Para obtener más información sobre NitroTPM y el arranque seguro UEFI, consulta la documentación de Amazon.

Limitaciones

  • Actualmente, puedes usar NitroTPM y el arranque seguro en todas las regiones de AWS (incluidas las regiones de AWS GovCloud (EE. UU.)) excepto China.
  • No puedes habilitar NitroTPM y el arranque seguro UEFI en catálogos existentes. Si quieres un catálogo con NitroTPM y el arranque seguro UEFI habilitados, crea un nuevo catálogo.

Pasos clave

  1. Configura tu entorno de AWS.
  2. Crea una conexión a AWS.
  3. Crea una imagen maestra (AMI) con NitroTPM y/o arranque seguro UEFI habilitados.
  4. Crea una imagen preparada a partir de la imagen maestra. Consulta Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core.
  5. Crea un catálogo de máquinas seleccionando la imagen preparada con NitroTPM y el arranque seguro UEFI habilitados en el menú de creación de catálogos de Citrix Studio o al crear un esquema de aprovisionamiento mediante comandos de PowerShell.

Las máquinas virtuales agregadas al catálogo creado tienen NitroTPM y el arranque seguro UEFI habilitados.

Crea una AMI compatible con NitroTPM y el arranque seguro UEFI

  1. Puedes crear una AMI a partir de una máquina virtual que tenga NitroTPM y/o arranque seguro UEFI habilitados.

    1. Crea la instancia usando las imágenes de AWS Marketplace. Por ejemplo, busca TPM-Windows_Server-2022-English-Full-Base en el aws-marketplace.
    2. Descarga VDA de sesión única o múltiple.
    3. Crea una AMI a partir de esa máquina virtual.

  2. Usa el comando register-image:

    --boot-mode (string)
--tpm-support (string)
<!--NeedCopy-->

    Para obtener más información, consulta register-image.

Consulta los siguientes documentos de AWS:

Puedes abrir una ventana de PowerShell desde el host de Delivery Controller™ para comprobar si un elemento específico:

  • servicio admite NitroTPM o el arranque seguro UEFI

     (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode
 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions
 <!--NeedCopy-->

  • plantilla admite NitroTPM o el arranque seguro UEFI

     (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport
 <!--NeedCopy-->

Actualiza la oferta de servicio de un catálogo existente

Puedes cambiar la oferta de servicio de un catálogo existente usando Set-ProvScheme. El cambio se aplica a las máquinas virtuales recién agregadas. Sin embargo, obtendrás errores en los siguientes escenarios:

Modo de arranque de las AMI ¿La AMI es compatible con Nitro TPM? ¿La oferta de servicio es compatible con NitroTPM y el arranque seguro UEFI?
UEFI No No
Legacy BIOS Sí No
UEFI Sí No
UEFI preferido Sí No

Copiar etiquetas en las máquinas virtuales

Puedes copiar etiquetas en las NIC y en los discos (disco de identidad, disco de caché de escritura diferida y disco del sistema operativo) que se especifican en el perfil de máquina a las máquinas virtuales recién creadas en un catálogo de máquinas de MCS. Puedes especificar estas etiquetas en cualquiera de las fuentes del perfil de máquina (instancia de máquina virtual de AWS o versión de plantilla de lanzamiento de AWS). Esta función se aplica a los catálogos de máquinas y máquinas virtuales persistentes y no persistentes.

Nota:

  • En la consola de AWS EC2, no puedes ver los valores de Tag Network Interfaces en Launch Template Version Resource Tags. Sin embargo, puedes ejecutar el comando de PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 para ver las especificaciones de las etiquetas.
  • Si una fuente de perfil de máquina (máquina virtual o versión de plantilla de lanzamiento) tiene dos interfaces de red (eni-1 y eni-2), y eni-1 tiene la etiqueta t1 y eni-2 tiene la etiqueta t2, la máquina virtual obtiene las etiquetas de ambas interfaces de red.

Filtrar instancias de máquinas virtuales con PowerShell

Una instancia de máquina virtual de AWS que uses como máquina virtual de perfil de máquina debe ser compatible para que el catálogo de máquinas se cree y funcione correctamente. Para enumerar las instancias de máquinas virtuales de AWS que se pueden usar como máquinas virtuales de entrada de perfil de máquina, puedes usar el comando Get-HypInventoryItem. El comando puede paginar y filtrar el inventario de máquinas virtuales disponibles en una unidad de alojamiento.

Paginación:

Get-HypInventoryItem admite dos modos de paginación:

  • El modo de paginación usa los parámetros -MaxRecords y -Skip para devolver conjuntos de elementos:
    • -MaxRecords: El valor predeterminado es 1. Esto controla cuántos elementos se deben devolver.
    • -Skip: El valor predeterminado es 0. Esto controla cuántos elementos se deben omitir desde el principio absoluto (o el final absoluto) de la lista en el hipervisor.
  • El modo de desplazamiento usa los parámetros -MaxRecords, -ForwardDirection y -ContinuationToken para permitir el desplazamiento de los registros:
    • -ForwardDirection: El valor predeterminado es True. Se usa junto con -MaxRecords para devolver el siguiente conjunto de registros coincidentes o el conjunto anterior de registros coincidentes.
    • -ContinuationToken: Devuelve los elementos inmediatamente después (o antes si ForwardDirection es false), pero sin incluir el elemento dado en el ContinuationToken.

Ejemplos de paginación:

  • Para devolver un solo registro de la plantilla de máquina con el nombre más bajo. El campo AdditionalData contiene TotalItemsCount y TotalFilteredItemsCount:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
 <!--NeedCopy-->

  • Para devolver 10 registros de la plantilla de máquina con el nombre más bajo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
 <!--NeedCopy-->

  • Para devolver una matriz de registros que terminan con el nombre más alto:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
 <!--NeedCopy-->

  • Para devolver una matriz de registros que comienzan en la plantilla de máquina asociada con el ContinuationToken dado:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
 <!--NeedCopy-->

Filtrado:

Los siguientes parámetros opcionales adicionales son compatibles con el filtrado. Puedes combinar estos parámetros con las opciones de paginación.

  • -ContainsName "my_name": Si la cadena dada coincide con parte de un nombre de AMI, la AMI se incluye en el resultado de Get. Por ejemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
 <!--NeedCopy-->

  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Si una AMI tiene al menos una de estas etiquetas, se incluye en el resultado de Get. Por ejemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 <!--NeedCopy-->

    Nota:

    Se admiten dos valores de etiqueta. El valor de etiqueta No etiquetado coincide con los elementos que no tienen la etiqueta dada en su lista de etiquetas. El valor de etiqueta Todos los valores coincide con los elementos que tienen la etiqueta, independientemente del valor de la etiqueta. De lo contrario, la coincidencia solo se produce si el elemento tiene la etiqueta y el valor es igual al que se proporciona en el filtro.

  • -Id "ami-0a2d913927e0352f3": Si la AMI coincide con el ID dado, se incluye en el resultado de Get. Por ejemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
 <!--NeedCopy-->

Filtrado en el parámetro AdditionalData:

El parámetro de filtro AdditionalData enumera las plantillas o máquinas virtuales en función de su capacidad, oferta de servicio o cualquier propiedad que se encuentre en AdditionalData. Por ejemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

También puedes agregar un parámetro -Warn para indicar las máquinas virtuales incompatibles. Las máquinas virtuales se incluyen con un campo AdditionalData llamado Warning. Por ejemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Pasos siguientes

Más información

Crear un catálogo de instancias administradas de Amazon WorkSpaces Core
March 25, 2026
Contribución de: 
C
March 25, 2026
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.