Citrix Virtual Apps and Desktops

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

May 31, 2026

Contribución de:

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, debe terminar de crear:

Una conexión a instancias administradas de Amazon WorkSpaces Core. Consulte Conexión a instancias administradas de Amazon WorkSpaces Core
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 de 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.

Nota:

Las propiedades del volumen EBS se derivan únicamente de un perfil de máquina.

El Servicio de metadatos de instancia (IMDS) V2 es el único compatible, no IMDS V1. Para obtener información, consulte Cómo funciona la versión 2 del Servicio de metadatos de instancia.

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 sus instancias de Amazon WorkSpaces Core se ejecutan solo en hardware con otras instancias que usted haya 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 la 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 la máquina.

Hardware compartido: Esta configuración es adecuada para la mayoría de las implementaciones. Varios clientes comparten 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 soporte limitado para Bring Your Own License (BYOL).

Crear un catálogo

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 máquina virtual de AWS o una versión de plantilla de lanzamiento de AWS como entrada del perfil de máquina.

Puede crear un catálogo mediante:

Web Studio
PowerShell

Crear un catálogo mediante 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 con 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 de catálogos. 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:

Seleccione una versión de imagen y haga clic en Crear catálogo. Haga clic en Siguiente en la página Introducción.
En las páginas Administración de máquinas e Imagen, la configuración está preseleccionada según la versión de imagen seleccionada. En la página Imagen, introduzca una nota para la imagen preparada seleccionada.
Complete la configuración en las siguientes páginas.
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.
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:

Haga clic en Catálogos de máquinas en el panel de navegación izquierdo.
Haga clic en Crear catálogo de máquinas. Aparece la página Configuración del catálogo de máquinas.
En la página Tipo de máquina, seleccione un tipo de máquina para el catálogo, por ejemplo, SO multisesión.
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.
En la página Experiencia de escritorio, seleccione un escritorio aleatorio o estático que desee que tengan los usuarios cuando inicien 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).
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 inicio, haga clic en el botón de edición.
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.
En la página NIC, seleccione las NIC (o ENI) para las VM.
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 unirse a un dominio.
2. Especifique el esquema de nombres de cuenta para las nuevas cuentas que se crearán para las VM.
En la página Credenciales de dominio, haga clic en Introducir credenciales para proporcionar las credenciales del dominio seleccionado. Introduzca el nombre de usuario y la contraseña de nivel de administrador cuando se le solicite. También puede usar una cuenta de servicio si ya ha guardado credenciales de dominio anteriormente siguiendo nuestra documentación del producto.
Haga clic en las páginas restantes hasta llegar a la página Resumen. Introduzca un nombre para el catálogo de máquinas y seleccione Finalizar para crear el catálogo de máquinas.

Limitaciones en la creación de un catálogo de máquinas en una zona local de AWS

Ciertas zonas locales solo admiten determinadas 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.
Debe seleccionar un perfil de máquina con especificaciones de hardware compatibles en la zona local deseada.
Las instantáneas de AMI de imagen preparada y las instantáneas de disco 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 mediante PowerShell

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

Cree 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-->

Cree 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, haga lo siguiente. También puede cambiar el tipo de tenencia y la capacidad de hibernación del origen del perfil de máquina al editar un catálogo de máquinas de MCS.

Ejecute 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 la versión de la plantilla de lanzamiento mediante PowerShell

Puede crear un catálogo de máquinas MCS con una versión de plantilla de lanzamiento como entrada de perfil de máquina. También puede 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, puede proporcionar la información de configuración de instancia de una plantilla de lanzamiento junto con el número de versión. Cuando especifica 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á un error apropiado.

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

Abra una ventana de PowerShell.
Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

Obtenga 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-->

Cree un grupo de identidades si no se ha creado. Por ejemplo:

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

Cree 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-->

Registre un esquema de aprovisionamiento como catálogo de intermediarios. Por ejemplo:

New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->

Termine de crear el catálogo.

Actualizar el origen del perfil de máquina

También puede 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 e ID

Puede crear un catálogo de VM con claves 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 administrar manualmente.

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

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

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

Limitaciones

Tenga en cuenta las siguientes limitaciones:

Actualmente, MCS solo admite un disco en la AMI de imagen preparada.
No puede cifrar directamente volúmenes o instantáneas de EBS existentes sin cifrar, ni modificar la clave KMS de un volumen cifrado existente. Para ello, debe:
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.

Consulte los siguientes documentos de AWS:

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

Crear un catálogo con cifrado de disco

Puede crear un catálogo de máquinas MCS con cifrado de disco utilizando:

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

Las consideraciones al usar la entrada del perfil de máquina son:

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, entonces la clave KMS de la AMI de imagen preparada se utiliza para cifrar los discos de las VM 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 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

Puede modificar un catálogo existente utilizando 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 añadidas 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, ejecute Set-ProvScheme con un nuevo perfil de máquina.
No puede modificar un catálogo existente para pasar de tener volúmenes cifrados a volúmenes sin cifrar. No puede 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 puede seleccionar una imagen preparada (AMI) con NitroTPM y/o arranque seguro UEFI habilitado. 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, consulte la documentación de Amazon.

Limitaciones

Actualmente, puede usar tanto NitroTPM como Secure Boot en todas las regiones de AWS (incluidas las regiones de AWS GovCloud (EE. UU.)), excepto en China.
No puede habilitar NitroTPM y el arranque seguro UEFI en catálogos existentes. Si desea un catálogo con NitroTPM y el arranque seguro UEFI habilitados, cree un catálogo nuevo.

Pasos clave

Configure su entorno de AWS.
Cree una conexión a AWS.
Cree una imagen maestra (AMI) con NitroTPM y/o arranque seguro UEFI habilitados.
Cree una imagen preparada a partir de la imagen maestra. Consulte Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core.
Cree 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 máquinas virtuales (VM) añadidas al catálogo creado tienen NitoTPM y el arranque seguro UEFI habilitados.

Cree una AMI que admita NitroTPM y el arranque seguro UEFI

Puede crear una AMI a partir de una máquina virtual (VM) que tenga NitroTPM y/o el arranque seguro UEFI habilitados.
1. Cree la instancia a partir de las imágenes del AWS Marketplace. Por ejemplo, busque TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
2. Descargue VDA de sesión única o múltiple.
3. Cree una AMI a partir de esa máquina virtual (VM).
Utilice el comando register-image:
```
--boot-mode (string)
--tpm-support (string)

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

Consulte los siguientes documentos de AWS:

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

la oferta de 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-->

la 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 del catálogo existente

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

Modo de arranque de las AMI	¿La AMI admite Nitro TPM?	¿La oferta de servicio admite NitroTPM y el arranque seguro UEFI?
UEFI	No	No
BIOS heredado	Sí	No
UEFI	Sí	No
UEFI preferido	Sí	No

Copiar etiquetas en las VM

Puede copiar etiquetas en las NIC y en los discos (disco de identidad, disco de caché de reescritura y disco del SO) que se especifican en el perfil de máquina en las VM recién creadas en un catálogo de máquinas MCS. Puede especificar estas etiquetas en cualquiera de los orígenes del perfil de máquina (instancia de VM 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 VM persistentes y no persistentes.

Nota:

En la consola de AWS EC2, no puede ver los valores de Tag Network Interfaces en Launch Template Version Resource Tags. Sin embargo, puede 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 (VM 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 VM obtiene las etiquetas de ambas interfaces de red.

Filtrar instancias de VM mediante PowerShell

Una instancia de VM de AWS que utilice como VM 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 VM de AWS que se pueden usar como VM de entrada de perfil de máquina, puede usar el comando Get-HypInventoryItem. El comando puede paginar y filtrar el inventario de VM disponibles en una unidad de alojamiento.

Paginación:

Get-HypInventoryItem admite dos modos de paginación:

El modo de paginación utiliza 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 utiliza los parámetros -MaxRecords, -ForwardDirection y -ContinuationToken para permitir el desplazamiento de los registros:
- -ForwardDirection: El valor predeterminado es True. Se utiliza 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 proporcionado en 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 tiene TotalItemsCount y TotalFilteredItemsCount:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
 
```

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 para el filtrado. Puede 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, entonces la AMI se incluye en el resultado 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 Get. Por ejemplo:
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 
```
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 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 puede agregar un parámetro -Warn para indicar las máquinas virtuales incompatibles. Las máquinas virtuales se incluyen con un campo AdditionalData denominado Advertencia. Por ejemplo:

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

Dónde ir a continuación

Para administrar un catálogo de Amazon Workspaces Core, consulte Administrar un catálogo de instancias administradas de Amazon WorkSpaces Core

Más información

Entornos de virtualización de AWS
Conexión a instancias administradas de Amazon WorkSpaces Core
Administración de imágenes
Crear una imagen preparada para Amazon WorkSpaces Core Managed Instances(/es-es/citrix-virtual-apps-desktops/2511/install-configure/create-prepared-image-amazon-wsc.html)
Para ver ejemplos de PowerShell de GitHub de Amazon WorkSpaces Core, consulte citrix-mcs-sdk-samples-Amazon WorkSpaces Core.

La documentación oficial de este producto está en inglés. Las versiones en otros idiomas se ofrecen solo como referencia y pueden incluir contenido traducido de forma automática. Para obtener más información, consulte la cláusula de exención de responsabilidad sobre traducción automática en Cloud Software Group home.

¿Le ha resultado útil?

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

May 31, 2026

Contribución de:

May 31, 2026

Contribución de:

En este artículo

Requisitos previos
Configuración de red durante la preparación de la imagen
Un catálogo de máquinas basado en perfiles de máquina
Tenencia de AWS
Crear un catálogo
Crear un catálogo mediante Web Studio
Crear un catálogo mediante PowerShell
Cifrar discos de SO e ID
Habilitar NitroTPM y el arranque seguro UEFI para instancias de VM
Copiar etiquetas en las VM
Filtrar instancias de VM mediante PowerShell
Dónde ir a continuación
Más información

¿Le ha resultado útil?