Citrix Virtual Apps and Desktops 7 2311

Crear un catálogo de AWS

May 31, 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 los entornos de virtualización de AWS.

Nota:

Antes de crear un catálogo de AWS, debe terminar de crear una conexión a AWS. Consulte Conexión a AWS.

Limitación

A partir de Citrix Virtual Apps and Desktops™ 2203 LTSR y versiones posteriores, el complemento MCS AWS realiza la llamada a la API de AWS DescribeInstanceTypes y, si tiene éxito, MCS utiliza el nombre de inventario creado a partir de la respuesta de la API.

Por lo tanto, cuando actualice de CVAD 1912 a 2203 o posterior, deshabilite el permiso DefineInstanceType en AWS y, a continuación, actualice el catálogo existente utilizando el comando Set-ProvScheme para que coincida con el esquema de nomenclatura de AWS. Luego, vuelva a agregar los permisos DescribeInstanceType una vez que se complete la actualización del catálogo y la oferta de servicio coincida con el esquema de nomenclatura de AWS.

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.

Configurar la tenencia de AWS

AWS ofrece las siguientes opciones de tenencia:

Tenencia compartida (el tipo predeterminado): Varias instancias de Amazon EC2 de diferentes clientes pueden residir en la misma pieza de hardware físico.
Tenencia dedicada: Sus instancias EC2 se ejecutan solo en hardware con otras instancias que usted ha implementado. Otros clientes no utilizan la misma pieza de hardware.

Puede usar MCS para aprovisionar hosts dedicados de AWS mediante PowerShell.

Configurar la tenencia de host dedicado de AWS mediante PowerShell

Puede crear un catálogo de máquinas con la tenencia de host definida a través de PowerShell.

Un host dedicado de Amazon [EC2] es un servidor físico con capacidad de instancia [EC2] totalmente dedicada, lo que le permite utilizar licencias de software existentes por socket o por máquina virtual.

Los hosts dedicados tienen una utilización preestablecida basada en el tipo de instancia. Por ejemplo, un único host dedicado asignado de tipos de instancia C4 Large está limitado a ejecutar 16 instancias. Consulte el sitio de AWS para obtener más información.

Los requisitos para el aprovisionamiento en hosts de AWS incluyen:

Una imagen BYOL (traiga su propia licencia) importada (AMI). Con los hosts dedicados, utilice y administre sus licencias existentes.
Una asignación de hosts dedicados con suficiente utilización para satisfacer las solicitudes de aprovisionamiento.
Habilitar la ubicación automática.

Para aprovisionar en un host dedicado en AWS mediante PowerShell, utilice el cmdlet New-ProvScheme con el parámetro TenancyType establecido en Host.

Consulte la documentación para desarrolladores de Citrix para obtener más información.

Capturar propiedades de máquina de las AMI

Cuando crea un catálogo para aprovisionar máquinas mediante Machine Creation Services (MCS) en AWS, selecciona una AMI para representar la imagen maestra/dorada de ese catálogo. A partir de esa AMI, MCS utiliza una instantánea del disco. En versiones anteriores, si quería roles o etiquetas en sus máquinas, utilizaba la consola de AWS para configurarlos individualmente. Esta funcionalidad está habilitada de forma predeterminada.

Sugerencia:

Para utilizar la captura de propiedades de instancia de AWS, debe tener una máquina virtual asociada a la AMI.

Para mejorar este proceso, MCS lee las propiedades de la instancia de la que se tomó la AMI y aplica el rol de Identity Access Management (IAM) y las etiquetas de la máquina a las máquinas aprovisionadas para un catálogo determinado. Al utilizar esta función opcional, el proceso de creación del catálogo busca la instancia de origen de la AMI seleccionada, leyendo un conjunto limitado de propiedades. Estas propiedades se almacenan luego en una plantilla de lanzamiento de AWS, que se utiliza para aprovisionar máquinas para ese catálogo. Cualquier máquina del catálogo hereda las propiedades de instancia capturadas.

Las propiedades capturadas incluyen:

Roles de IAM: aplicados a las instancias aprovisionadas.
Etiquetas: aplicadas a las instancias aprovisionadas, sus discos y NIC. Estas etiquetas se aplican a los recursos transitorios de Citrix®, incluidos: depósitos y objetos de S3, y AMI, instantáneas y plantillas de lanzamiento.

Sugerencia:

El etiquetado de los recursos transitorios de Citrix es opcional y se puede configurar mediante la propiedad personalizada AwsOperationalResourcesTagging.

Capturar la propiedad de instancia de AWS

Puede usar esta función especificando una propiedad personalizada, AwsCaptureInstanceProperties, al crear un esquema de aprovisionamiento para una conexión de alojamiento de AWS:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true" …<standard provscheme parameters

Consulte la documentación para desarrolladores de Citrix para obtener más información.

Nota:

El AwsCaptureInstanceProperties está obsoleto.

Capturar propiedades de máquina a partir de perfiles de máquina

Al crear un catálogo para aprovisionar máquinas AWS mediante MCS, puede usar un perfil de máquina para preestablecer ciertas configuraciones de propiedades de máquina.

Para ello, siga estos pasos:

Almacene los perfiles de máquina en la misma zona de disponibilidad que los recursos donde está creando este catálogo.
En la página Plantilla de máquina del asistente de creación de catálogos, seleccione Usar un perfil de máquina. Se muestran los perfiles de máquina que se encuentran en la misma zona disponible que los recursos seleccionados.
Seleccione un perfil de máquina según sea necesario.

Nota:

Puede usar un perfil de máquina o una AMI para capturar las propiedades de la máquina. En Web Studio, cuando selecciona Usar un perfil de máquina, la opción Aplicar propiedades de plantilla de máquina a máquinas virtuales se oculta automáticamente.

Etiquetar recursos operativos de AWS

Al crear un catálogo para aprovisionar máquinas en AWS mediante MCS, puede controlar si se aplican el rol de IAM y las propiedades de etiqueta a esas máquinas. También puede controlar si se aplican etiquetas de máquina a los recursos operativos.

Una Amazon Machine Image (AMI) representa un tipo de dispositivo virtual que se utiliza para crear una máquina virtual dentro del entorno de Amazon Cloud, comúnmente conocido como EC2. Se utiliza una AMI para implementar servicios que utilizan el entorno EC2. Al crear un catálogo para aprovisionar máquinas mediante MCS para AWS, se selecciona la AMI para que actúe como imagen de oro para ese catálogo.

Importante:

La creación de catálogos mediante la captura de una propiedad de instancia y una plantilla de lanzamiento es necesaria para usar el etiquetado de recursos operativos.

Para crear un catálogo de AWS, primero debe crear una AMI para la instancia que desea que sea la imagen de oro. MCS lee las etiquetas de esa instancia y las incorpora a la plantilla de lanzamiento. Las etiquetas de la plantilla de lanzamiento se aplican luego a todos los recursos de Citrix creados en su entorno de AWS, incluidos:

Máquinas virtuales
Discos de VM
Interfaces de red de VM
Buckets de S3
Objetos de S3
Plantillas de lanzamiento
AMI

Etiquetar un recurso operativo

Para usar PowerShell para etiquetar recursos:

Abra una ventana de PowerShell desde el host DDC.
Ejecute el comando asnp citrix para cargar los módulos de PowerShell específicos de Citrix.

Para etiquetar un recurso para una VM aprovisionada, utilice la nueva propiedad personalizada AwsOperationalResourcesTagging. La sintaxis de esta propiedad es:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true" …<standard provscheme parameters>

Qué hacer a continuación

Si este es el primer catálogo creado, Web Studio le guiará para crear un grupo de entrega
Para revisar todo el proceso de configuración, consulte Instalar y configurar
Para administrar catálogos, consulte Administrar catálogos de máquinas y Administrar un catálogo de AWS

Copiar etiquetas en las VM

Puede copiar etiquetas en NIC y discos (disco de identidad, disco de caché de reescritura y disco del SO) que se especifican en el perfil de máquina a 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 es aplicable a catálogos de máquinas y VM persistentes y no persistentes.

Nota:

En la consola de AWS EC2, no puede ver los valores de Etiquetar interfaces de red en Etiquetas de recursos de la versión de la plantilla de lanzamiento. 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, entonces la VM obtiene las etiquetas de ambas interfaces de red.

Crear un catálogo mediante un perfil de máquina

Al crear un catálogo para aprovisionar máquinas mediante Machine Creation Services™ (MCS) en AWS, ahora 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, propiedades de volumen de EBS, tipo de instancia, optimización de EBS y otras configuraciones de AWS compatibles. Al editar el catálogo, el perfil de máquina de las máquinas aprovisionadas se puede cambiar proporcionando una VM o una plantilla de lanzamiento diferente.

Nota:

Las propiedades de volumen de EBS se derivan solo de un perfil de máquina.

Consideraciones importantes

Las consideraciones importantes al crear un catálogo de máquinas MCS:

Si agrega parámetros de propiedades de hardware de máquina en los comandos New-ProvScheme y Set-ProvScheme, los valores proporcionados en los parámetros sobrescriben los valores del perfil de máquina.
Si establece AwsCaptureInstanceProperties como true y no establece la propiedad MachineProfile, solo se capturan los roles y las etiquetas de IAM.
No puede establecer AwsCaptureInstanceProperties y MachineProfile al mismo tiempo.

**Nota:

El AwsCaptureInstanceProperties está obsoleto.
Debe proporcionar explícitamente los valores de las siguientes propiedades:
- TenancyType
- Security Group
- NIC o red virtual
Solo puede habilitar AwsOperationalResourcesTagging si habilita AwsCaptureInstanceProperties o especifica un perfil de máquina.

Consideraciones importantes después de crear un catálogo de máquinas MCS:

Solo las nuevas máquinas virtuales añadidas al catálogo se ven afectadas por el cambio.
No se puede cambiar un catálogo de basado en perfil de máquina a no basado en perfil de máquina.

Crear un catálogo de máquinas mediante un perfil de máquina

Para crear un catálogo de máquinas mediante un perfil de máquina:

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

Cree un grupo de identidades si aún no lo ha hecho. Por ejemplo,

New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
<!--NeedCopy-->

Ejecute el comando New-ProvScheme. Por ejemplo:

New-ProvScheme -ProvisioningSchemeName demet-test-1
-HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
-IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
-CleanOnBoot
-MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
-MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
<!--NeedCopy-->

Termine de crear el catálogo. Para obtener más información, consulte Citrix PowerShell SDK.

Para actualizar el perfil de máquina en un catálogo que se aprovisionó inicialmente con un perfil de máquina:

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

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 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
Grupos de seguridad
Tipo de tenencia

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 está 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" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

También puede anular parámetros como la oferta de servicio, los grupos de seguridad, la tenencia y las redes. Por ejemplo:

New-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid " c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
-IdentityPoolUid " bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxx).launchtemplate\lt-01xxxx (1).launchtemplateversion" `
-ServiceOffering "XDHyp:\HostingUnits\xxxd-ue1a\T3 Large Instance.serviceoffering"
<!--NeedCopy-->

Registre el esquema de aprovisionamiento como un 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-->

Termine de crear el catálogo. Para obtener más información, consulte Citrix PowerShell SDK

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

Filtrar instancias de VM

Una instancia de AWS EC2 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 AWS EC2 que se pueden utilizar como VM de entrada de perfil de máquina, puede utilizar 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 posteriores (o anteriores si ForwardDirection es false) pero sin incluir el elemento dado 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 especifica 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 las plantillas o las 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 añadir un parámetro -Warn para indicar las VM incompatibles. Las VM se incluyen con un campo AdditionalData llamado Advertencia. Por ejemplo:

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

Más información

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 AWS

May 31, 2026

Contribución de:

C C

May 31, 2026

Contribución de:

C C

En este artículo

Limitación
Configuración de red durante la preparación de la imagen
Configurar la tenencia de AWS
Capturar propiedades de máquina de las AMI
Capturar propiedades de máquina a partir de perfiles de máquina
Etiquetar recursos operativos de AWS
Qué hacer a continuación
Copiar etiquetas en las VM
Crear un catálogo mediante un perfil de máquina
Filtrar instancias de VM
Más información

¿Le ha resultado útil?