Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

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

April 7, 2026
Contribución de: 
C 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 tanto persistentes como no persistentes (la propiedad CleanOnBoot es True o False).

Requisitos previos

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

  1. Una conexión a instancias administradas de Amazon WorkSpaces Core. Consulte Conexión a instancias administradas de Amazon WorkSpaces Core
  2. Una imagen preparada. Consulte 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 VM original. Esta VM de preparación se desconecta de la red. Para desconectar la red de la VM 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 perfiles de máquina

Puede 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 del volumen EBS, la optimización de EBS, las opciones de CPU, la capacidad de hibernación y otras configuraciones de AWS compatibles.

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

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 sus instancias de Amazon WorkSpaces Core se ejecutan solo en hardware con otras instancias que usted ha implementado.

Nota:

Solo se admiten las instancias dedicadas (los hosts dedicados no se admiten actualmente). Otros clientes no utilizan el mismo hardware.

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

Cuando utiliza 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í. El uso de hardware compartido es la opción menos costosa para ejecutar sus 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, sigue disfrutando de los beneficios de tener un host separado de otros clientes de AWS, pero no paga por todo el host. No necesita preocuparse por la capacidad del host, pero se le cobra una tarifa más alta por las instancias. Además, las instancias dedicadas ofrecen asistencia limitada 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. Puede usar una instancia de VM de AWS o una versión de plantilla de lanzamiento de AWS como entrada del perfil de máquina.

Puede crear un catálogo utilizando:

Crear un catálogo con Web Studio

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

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

Alternativamente, puede 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. Consulte 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, haga lo siguiente:

    1. Seleccione una versión de imagen y haga clic en Crear catálogo. Haga clic en Siguiente en la página Introducción.
    1. 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, introduzca una nota para la imagen preparada seleccionada.
    1. Complete la configuración en las páginas siguientes.
    1. En la página Resumen, compruebe los detalles del catálogo de máquinas. Introduzca un nombre y una descripción para el catálogo de máquinas. Haga clic en Finalizar.
    1. Vaya 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, haga lo siguiente:

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

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

    1. Seleccione Máquinas con administración de energía (por ejemplo, máquinas virtuales o PC blade).
    2. Seleccione Tecnología de aprovisionamiento de Citrix. A continuación, seleccione Citrix Machine Creation Services™.
    3. En el campo Recursos, seleccione los recursos (zona de disponibilidad o zona local) que configuró al crear la conexión de host y haga clic en Siguiente.
  3. En la página Experiencia de escritorio, seleccione un escritorio aleatorio o estático que desee que los usuarios tengan al iniciar sesión. Si se selecciona un escritorio estático, especifique además si desea guardar los cambios que el usuario realice en el disco local (persistente o no persistente).

  4. En la página Imagen, haga clic en Seleccionar una imagen para seleccionar una imagen preparada para el catálogo de máquinas. Seleccione la versión preparada que creó. Haga clic en el nombre de la versión de la imagen. Para ver más detalles sobre la versión de imagen seleccionada, haga clic en el número de versión, que está subrayado. Haga 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 utilizan para crear máquinas en los catálogos. Para cambiar el origen del perfil de máquina a otra VM o versión de plantilla de lanzamiento, haga clic en el botón de edición.

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

    1. Introduzca el número de VM 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, seleccione el icono de edición y seleccione una especificación de máquina.
  6. En la página NICs, seleccione las NICs (o ENIs) para las VM.

  7. En la página Identidades de máquina, configure 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), seleccione el dominio y cree nuevas cuentas de AD para las VM que se crearán en este catálogo de máquinas. Las VM aprovisionadas se unen al dominio seleccionado. Para aprovisionar máquinas no unidas a un dominio, seleccione la opción de no unión a un dominio.
    2. Especifique el esquema de nombres de cuenta para las nuevas cuentas que se crearán para las VM.
  8. 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.
  9. Haz clic para avanzar por las páginas restantes hasta llegar a la página 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 las 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 utilizando 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 utilizando 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 utilizando 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 mientras editas 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 utilizando 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 a las VM VDA aprovisionadas.

  • Las siguientes propiedades se pueden proporcionar utilizando 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, obtendrás un error apropiado.

  • Para crear un catálogo utilizando 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

    ```

    1. 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” `

    ```

    1. 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”

    ```

  1. 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-->

  2. 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”

    ```

  • 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 e ID

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 SO 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 gestionar manualmente.

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

Para el cifrado de discos de SO e ID, configura una de las siguientes opciones:

  • Usar 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)
  • Usar un origen de perfil de máquina (VM o plantilla de lanzamiento) que contenga un volumen raíz de EBS cifrado.

Limitaciones 

-  Ten en cuenta las siguientes limitaciones:
  • MCS solo admite actualmente 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. 1. Crear un nuevo volumen a partir de esa instantánea. 1. Cifrar el nuevo volumen.

  • Consulta los siguientes documentos de AWS:

  • Cifrar recursos sin cifrar
  • Limitaciones del cifrado automático o predeterminado de los volúmenes de EBS: Cifrar automáticamente volúmenes de Amazon EBS existentes y nuevos.

Crear un catálogo con cifrado de disco

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

  • Imagen preparada (creada mediante la administración de imágenes a partir de una imagen maestra que tiene el disco cifrado)
  • 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, se usa la clave KMS de la AMI de imagen preparada para cifrar los discos de las VM del catálogo.
  • Si el perfil de máquina tiene asignaciones de dispositivos de bloque, 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 VM del catálogo no se cifran.
  • Cuando la imagen preparada está cifrada, una VM 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.

Modificar 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 VM 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.

Habilitar NitroTPM y el arranque seguro UEFI para instancias de VM

Al crear un catálogo, ahora puedes seleccionar una imagen preparada (AMI) con NitroTPM y/o arranque seguro UEFI habilitados. En consecuencia, las VM aprovisionadas en el catálogo también se habilitan con NitroTPM y/o arranque seguro UEFI. Esta implementación garantiza que las VM 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.
  1. Crea una conexión a AWS.
  2. Crea una imagen maestra (AMI) con NitroTPM y/o arranque seguro UEFI habilitados.
  3. Crea una imagen preparada a partir de la imagen maestra. Consulta Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core.
  4. 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 Web Studio o al crear un esquema de aprovisionamiento mediante comandos de PowerShell.

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

Crear una AMI compatible con NitroTPM y el arranque seguro UEFI

  1. Puedes crear una AMI a partir de una VM que tenga NitroTPM y/o el 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 VM.

  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:

  • servicio de oferta 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-->

Actualizar 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 VM 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
BIOS heredado 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 reescritura y disco del sistema operativo) que se especifican en el perfil de máquina en las máquinas virtuales recién creadas de un catálogo de máquinas de MCS. Puedes especificar estas etiquetas en cualquiera de los orígenes 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 las máquinas virtuales persistentes y no persistentes.

Nota:

  • En la consola de AWS EC2, no puedes ver los valores de Etiquetar interfaces de red en Etiquetas de recursos de la versión de la plantilla de lanzamiento. 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 un origen 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 utilices 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 devuelven.
    • -Skip: El valor predeterminado es 0. Esto controla cuántos elementos se omiten 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 único 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 Sin etiquetar 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 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 denominado Warning. Por ejemplo:

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

¿Qué hacer a continuación?

Más información

Crear un catálogo de instancias administradas de Amazon WorkSpaces Core
April 7, 2026
Contribución de: 
C C
April 7, 2026
Contribución de: 
C 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.