Documentación de productos

Citrix DaaS™

Ver PDF

Crear catálogos con imágenes preparadas en instancias administradas de Amazon WorkSpaces Core

May 4, 2026

Contribución de:

Crea imágenes preparadas y úsalas para crear un catálogo de máquinas MCS mediante:
Studio
PowerShell

Pasos clave

Crea la definición de imagen y la versión inicial de la imagen.
Crea versiones de imagen a partir de la versión inicial de la imagen.
Usa la versión de imagen como una imagen preparada para crear un catálogo.

Crear una definición de imagen y una versión inicial de imagen con Studio

Para crear una definición de imagen y la versión inicial de la imagen, haz lo siguiente:

En Studio, ve al nodo Imágenes y haz clic en Crear definición de imagen. Haz clic en Siguiente en la página Introducción.
En la página Definición de imagen, especifica el Tipo de SO y el Tipo de sesión para la definición de imagen.
En la página Imagen, selecciona Recursos (solo se enumeran los recursos aplicables para la conexión establecida), una imagen maestra para usar como plantilla para crear la versión de imagen y un perfil de máquina para capturar propiedades de hardware. Selecciona un perfil de máquina para capturar propiedades de hardware de una instancia de VM o de una versión de plantilla de lanzamiento.
Nota:
- Antes de seleccionar una imagen, verifica que la imagen maestra tenga VDA 2311 o posterior instalado y que el controlador MCSIO esté instalado en el VDA.
- Solo se admite el Servicio de metadatos de instancia (IMDS) V2, no IMDS V1. Para obtener información, consulta Cómo funciona la versión 2 del Servicio de metadatos de instancia.
En la página Especificación de máquina, selecciona un tamaño de máquina. El tamaño de máquina del perfil de máquina (seleccionado en la página Imagen) se selecciona de forma predeterminada.
En la página NIC, selecciona o agrega NIC para la imagen de preparación. Para cada NIC, selecciona una subred de VPC asociada.
En la página Descripción de la versión, introduce una descripción para la versión inicial de la imagen creada.
En la página Resumen, verifica los detalles de la definición de imagen y la versión inicial de la imagen creada. Introduce un nombre y una descripción para la definición de imagen. Haz clic en Finalizar.

Crear versiones de imagen con Studio

Las versiones de imagen permiten la administración de diferentes iteraciones o actualizaciones de una imagen en particular. Esta funcionalidad te permite mantener varias versiones de una imagen para diferentes propósitos.

Para crear versiones de imagen a partir de la versión inicial de la imagen, haz lo siguiente:

Nota:

La unidad de alojamiento de todas las versiones de imagen debe ser la misma.

Ve al nodo Imágenes, selecciona una versión de imagen o una definición de imagen y haz clic en Crear versión de imagen.
En la página Definición de imagen, puedes cambiar la unidad de alojamiento y volver a seleccionar la imagen maestra y el perfil de máquina para esa versión de imagen.
Si quieres que la configuración de la versión de imagen sea diferente de la versión de imagen configurada inicialmente, configura los ajustes en las páginas Especificación de máquina y NIC del cuadro de diálogo Crear versión de imagen.
Agrega una descripción para la versión de imagen. Haz clic en Finalizar.

Nota:

Si la creación de la versión de imagen falla por algún motivo, la ficha Solucionar problemas en la parte inferior proporciona una opción Reintentar.

Crear una especificación de versión de imagen preparada con PowerShell

Los comandos detallados de PowerShell para crear una especificación de versión de imagen preparada son los siguientes:

Comprueba los nombres de definición de imagen disponibles con el comando Test-ProvImageDefinitionNameAvailable. Por ejemplo,
```
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>


```

Crea una definición de imagen con el comando New-ProvImageDefinition. Por ejemplo,

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession

<!--NeedCopy-->

Crea una nueva configuración para la definición de imagen en la conexión de alojamiento especificada con el comando Add-ProvImageDefinitionConnection.
```
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn


```

Crea una versión de imagen con el comando New-ProvImageVersion. Por ejemplo,

New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

<!--NeedCopy-->

Agrega una especificación de versión de imagen maestra a la versión de imagen con el comando Add-ProvImageVersionSpec. Por ejemplo,
```
Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"


```
Nota:

Solo puedes agregar una especificación de versión de imagen maestra a una versión de imagen para una unidad de alojamiento.

Crea una especificación de versión de imagen preparada a partir de la especificación de versión de imagen maestra con el comando New-ProvImageVersionSpec. El parámetro SourceImageVersionSpecUid se deriva del comando Add-ProvImageVersionSpec. Por ejemplo,

 New-ProvImageVersionSpec
 -  -SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
 -  -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously

 <!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell para crear una definición de imagen, una versión de imagen y una especificación de versión de imagen preparada:

-  New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid

<!--NeedCopy-->

Nota:

Todas las especificaciones de versión de imagen en una definición de imagen deben pertenecer a la misma unidad de alojamiento.

Una versión de imagen solo puede tener una especificación de versión de imagen maestra y una especificación de versión de imagen preparada.

Todas las especificaciones de versión de imagen deben tener un perfil de máquina.

Compartir imágenes preparadas entre zonas de disponibilidad y regiones

Ahora puedes compartir una única imagen preparada entre diferentes zonas de disponibilidad, vinculadas a diferentes unidades de alojamiento, dentro de la misma región de AWS o en diferentes regiones para tus instancias administradas de Amazon WorkSpaces Core. Esto te permite usar una imagen preparada para crear y actualizar catálogos de máquinas MCS en varias zonas de disponibilidad y regiones. Al compartir entre diferentes zonas de disponibilidad en distintas regiones, la versión de la imagen preparada se copiará de la región original a las regiones de destino.

Puedes mantener una única imagen preparada y usarla para crear y actualizar catálogos de máquinas en múltiples zonas de disponibilidad y regiones vinculadas a diferentes unidades de alojamiento. Esto reduce significativamente la sobrecarga de gestión de imágenes, garantiza la coherencia en las implementaciones y agiliza el proceso de aprovisionamiento. También puedes actualizar sin problemas catálogos de máquinas existentes con imágenes preparadas de una zona de disponibilidad o región diferente.

Casos de uso

Gestión centralizada de imágenes: Creas una imagen preparada en una zona de disponibilidad (por ejemplo, us-east-1a). Luego puedes compartir esta imagen con otras zonas de disponibilidad como us-east-1b dentro de la misma región de AWS us-east-1 o us-west-1a en una región us-west-1 diferente. Esto permite que una única imagen sirva a múltiples unidades de alojamiento y simplifica el mantenimiento para ti.
Creación y actualización eficiente de catálogos: Puedes usar una imagen preparada creada en la AZ 1 (por ejemplo, us-east-1a) para crear nuevos catálogos en la AZ 1. Después de compartir esta imagen con la AZ 2 (por ejemplo, us-east-1b), puedes usar la imagen compartida en la AZ 2 para crear y actualizar catálogos en la AZ 2.
Implementaciones entre unidades de alojamiento y conexiones de alojamiento: Si tu entorno tiene múltiples unidades de alojamiento bajo las mismas o diferentes regiones de AWS, puedes compartir eficientemente imágenes preparadas entre estas unidades de alojamiento.

Limitaciones

Compartir dentro de la misma cuenta de AWS: No puedes compartir entre diferentes cuentas de AWS en la implementación actual.

Consideraciones importantes

Orden de eliminación: Para eliminar una especificación de versión de imagen preparada original, primero debes eliminar todas sus especificaciones de versión de imagen compartidas. Alternativamente, debes eliminar las especificaciones originales y compartidas simultáneamente.
Dependencia de la versión de la imagen: Cuando quitas una versión de imagen, primero debes quitar cualquier configuración de uso compartido que dependa de esa versión de imagen específica. Los catálogos que creaste a partir de la imagen original (no compartida) pueden permanecer intactos.
Retrocompatibilidad del catálogo: Puedes actualizar catálogos de máquinas existentes que implementaste antes de la introducción de esta función. Usa imágenes preparadas que creaste en una zona de disponibilidad o región diferente de donde implementaste originalmente el catálogo.
Eliminación completa: Cuando eliminas una imagen preparada, ya no puedes usarla en ninguna zona de disponibilidad donde la compartiste o la creaste originalmente. Además, una versión de imagen preparada no se puede eliminar hasta que se eliminen primero todos los catálogos vinculados a esa versión de imagen preparada.

Requisitos previos

Antes de configurar o usar esta función, asegúrate de cumplir las siguientes condiciones:

Tu entorno debe ser un entorno de instancias administradas de Amazon WorkSpaces Core.
Debes configurar múltiples unidades de alojamiento (cada una puede estar vinculada a diferentes zonas de disponibilidad) y conexiones de host (cada una puede estar vinculada a una región diferente) bajo la misma cuenta de AWS.

Configurar usando la interfaz de usuario de Studio

Puedes compartir imágenes preparadas entre zonas de disponibilidad vinculadas a diferentes unidades de alojamiento usando la interfaz de usuario de Studio.

Para compartir una imagen preparada

Navega al nodo de Imágenes de Studio y selecciona la versión de imagen preparada que quieres compartir con otras zonas de disponibilidad.
Selecciona Administrar uso compartido de imágenes en la barra de navegación superior para gestionar el uso compartido de imágenes para la versión de imagen seleccionada.

1. En la página Administrar uso compartido de imágenes, selecciona uno o más recursos con los que quieres compartir la versión de la imagen. Los recursos pueden estar en zonas de disponibilidad diferentes a las de la versión de imagen original.

Haz clic en Guardar para compartir la versión de la imagen en los recursos de otras zonas de disponibilidad. La versión de la imagen se actualiza de modo que se comparte entre los diferentes recursos que seleccionaste. Una vez completado, usa la versión de la imagen para crear catálogos en las zonas de disponibilidad en las que se comparte la versión de la imagen.

Para quitar el uso compartido de una imagen preparada

1. En el nodo de Imágenes de Studio, selecciona la versión de imagen preparada de la que quieres quitar el uso compartido.
1. Selecciona Administrar uso compartido de imágenes en la barra de navegación superior para gestionar el uso compartido de imágenes para la versión de imagen seleccionada.
1. Desmarca las casillas de verificación de uno o más recursos (zonas de disponibilidad) con los que quieres dejar de compartir la versión de la imagen.
Nota:

Los recursos ya no deben tener ningún catálogo asociado y creado a partir de la versión de imagen compartida. Cualquier catálogo creado a partir de la versión de imagen compartida que se vaya a quitar debe eliminarse primero.

Haz clic en Guardar para quitar el uso compartido de los recursos en las zonas de disponibilidad desmarcadas. La versión de la imagen se actualiza de modo que ya no se comparte en esas zonas de disponibilidad.

Configurar usando PowerShell

Alternativamente, puedes compartir imágenes preparadas entre zonas de disponibilidad vinculadas a diferentes unidades de alojamiento usando comandos de PowerShell.

Para compartir una imagen preparada

Asegúrate de tener el ImageVersionSpecUid de la imagen preparada que quieres compartir. Puedes recuperarlo usando Get-ProvImageVersionSpec o comandos Get- similares en PowerShell.
Determina el HostingUnitName de la zona de disponibilidad (puede ser la misma región o una diferente) donde quieres que la imagen preparada esté disponible. Este es el nombre de la unidad de alojamiento que configuraste para esa zona de disponibilidad específica.
Ejecuta el comando Add-ProvImageVersionSpecHostingUnit: Usa el siguiente comando de PowerShell. Reemplaza <ImageVersionSpecUid> con el Uid de tu imagen y <targetHostingUnitName> con el nombre de la unidad de alojamiento en la zona de disponibilidad de destino a la que quieres compartir la especificación de la versión de la imagen:
```
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```
Después de una ejecución exitosa, puedes ver el estado de la imagen en la interfaz de usuario de Studio, lo que indica que la compartiste con la unidad de alojamiento especificada.

Para quitar el uso compartido de una imagen preparada

Asegúrate de tener el ImageVersionSpecUid de la imagen preparada de la que quieres quitar el uso compartido.
Determina el HostingUnitName de la zona de disponibilidad de la que quieres quitar la imagen compartida.
Ejecuta el comando Remove-ProvImageVersionSpecHostingUnit: Usa el siguiente comando de PowerShell. Reemplaza <ImageVersionSpecUid> con el Uid de tu imagen y <targetHostingUnitName> con el nombre de la unidad de alojamiento en la zona de disponibilidad de destino de la que quieres quitar el uso compartido de la especificación de la versión de la imagen:
```
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```

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

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 del volumen 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:

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

Solo se admite el Servicio de metadatos de instancia (IMDS) V2, no IMDS V1. Para obtener más información, consulta 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 tus instancias de Amazon WorkSpaces Core se ejecutan solo en hardware con otras instancias que tú hayas implementado.

Nota:

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

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

Cuando utilizas 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).

Facturación flexible

Amazon WorkSpaces Core Managed Instances admite dos modos de facturación:

Modo de facturación	Descripción
Mensual	Facturación fija mensual. Ideal para escritorios persistentes y cargas de trabajo predecibles.
Por horas	Facturación de pago por uso. Esta es la configuración predeterminada de AWS si no se especifica explícitamente ningún modo de facturación.

Estas opciones proporcionan flexibilidad para gestionar los costes de computación en función de la persistencia y los patrones de uso de tu carga de trabajo.

Esta función requiere el uso del servicio de facturación de Amazon WorkSpaces. De forma predeterminada, MCS utiliza este servicio para aprovisionar y gestionar instancias, lo que te permite beneficiarte de precios fijos más competitivos para cargas de trabajo persistentes.

Requisitos previos y consideraciones

Configuración de la cuenta de AWS: Tu cuenta de AWS debe estar configurada para usar el servicio de facturación de WorkSpaces. Aunque las cuentas de AWS se cambian de forma predeterminada, algunos clientes pueden solicitar a AWS que permanezca en el servicio de facturación de EC2 heredado para usar WorkSpaces Core Managed Instances.

Nota:

Si tu cuenta está en el servicio de facturación de EC2 heredado, la opción de facturación Mensual no está disponible.
Conexión de host: La facturación flexible solo se aplica a las conexiones de host de Amazon WorkSpaces Core. No se admite para las conexiones de host estándar de AWS EC2.
Instancias Spot: Las instancias Spot no se admiten con el servicio de facturación de WorkSpaces.
Facturación mixta: Una cuenta de AWS debe usar la facturación de WorkSpaces o la facturación de EC2 para las instancias administradas principales. No se admite una combinación de ambas en una sola cuenta.
Compatibilidad: Solo tipos de instancia, tipos de plataforma (SO) y tipos de tenencia específicos son compatibles con ciertos modos de facturación. MCS realiza una comprobación previa para asegurarse de que tus selecciones (Oferta de servicio, Perfil de máquina e Imagen preparada) coincidan con el modo de facturación elegido.

Consulta Crear un catálogo de máquinas con un modo de facturación específico.

Crear un catálogo

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

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

Antes de crear un catálogo de Amazon WorkSpaces Core Managed Instances, debes terminar de crear:

Una conexión a Amazon WorkSpaces Core Managed Instances. Consulta Conexión a Amazon WorkSpaces Core Managed Instances
Una imagen preparada.

Puedes crear un catálogo usando:
Studio
PowerShell

Crear un catálogo usando 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:

Selecciona una versión de imagen y haz clic en Crear catálogo. Haz clic en Siguiente en la página Introducción.

1. En las páginas Administración de máquinas e Imagen, la configuración está preseleccionada en función de la versión de imagen seleccionada. En la página Imagen, introduce una nota para la imagen preparada seleccionada.

Completa la configuración en las páginas siguientes.
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.
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:

Haz clic en Catálogos de máquinas en el panel de navegación izquierdo.
Haz 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, selecciona un tipo de máquina para el catálogo, por ejemplo, SO multisesión.
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.

En la página Experiencia de escritorio, selecciona el escritorio aleatorio o estático que deseas que tengan los usuarios cuando inicien sesión. Si se selecciona un escritorio estático, especifica además si deseas guardar los cambios que el usuario realice en el disco local (persistente o no persistente).
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.

El perfil de máquina asociado a la imagen preparada aparece 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, haz clic en el botón de edición.
En la página Máquinas virtuales:
1. Introduce 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, selecciona el icono de edición y selecciona una especificación de máquina.
En la página NIC, selecciona las NIC (o ENI) para las VM.
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 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, 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 VM.
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.
Haz clic en 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

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.
Debes seleccionar un perfil de máquina con especificaciones de hardware compatibles con 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 con PowerShell

Crear un catálogo usando 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 usando 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 usando 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.

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 de máquinas con un modo de facturación específico

-  Actualmente, puedes especificar el modo de facturación al crear un catálogo de máquinas usando solo PowerShell.

Para especificar el modo de facturación a través de PowerShell, usa el parámetro CustomProperties en el comando New-ProvScheme.

$custprop = "BillingMode,Monthly" 
 
New-ProvScheme -ProvisioningSchemeName "MyCatalog" ` 
-ImageVersionSpecUid $ImageVersionSpecUid ` 
-HostingUnitName "wsc-unit" ` 
-IdentityPoolName "MyIdentityPool" ` 
-MachineProfile "XdHyp:\HostingUnits\wsc-unit\machine-profile lt-123.launchtemplate\lt-123 (1).launchtemplateversion" ` 
-CustomProperties $custprop ` 
-CleanOnBoot

<!--NeedCopy-->

Nota:

Si se omite la propiedad BillingMode, el catálogo se establece por defecto en Hourly.

Cambiar el modo de facturación de un catálogo existente

Puedes convertir un catálogo existente de Monthly a Hourly, o viceversa. Este cambio puede aplicarse tanto a las VM nuevas como a las existentes en el catálogo.

Consideraciones importantes para las actualizaciones

Ventana de servicio: Las VM existentes deben pasar por una ventana de servicio o un ciclo de encendido para aplicar el cambio de facturación.
Validación: MCS valida que los tipos de instancia y las plataformas existentes sean compatibles con el nuevo modo de facturación antes de aplicar el cambio.

Actualizar usando PowerShell

Para actualizar el modo de facturación solo de las VM nuevas agregadas a un catálogo, actualiza la propiedad personalizada del modo de facturación del esquema de aprovisionamiento:
```
 -  $custprop = "BillingMode,Hourly"

 Set-ProvScheme -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop

 
```

Para actualizar el modo de facturación de las VM nuevas y existentes en un catálogo, crea una nueva versión del esquema de aprovisionamiento con la propiedad personalizada actualizada y aplica la nueva versión a todas las VM:

 $custprop = "BillingMode,Hourly"

 -  New-ProvSchemeVersion -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop

     New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 2 `
 -  -StartsNow -AllVMs `
 -  -MaxDurationInMinutes 100 `
     -ProvisioningSchemeName "MyCatalog"

 <!--NeedCopy-->

Supervisar la información de facturación

Puedes verificar el modo de facturación para catálogos y máquinas virtuales individuales.

Ejecuta los siguientes comandos de PowerShell para comprobar la elegibilidad de facturación de tu cuenta:

Devuelve BillingMode como parte de CustomProperties

 -  Get-ProvScheme –ProvisioningSchemeName “"MyCatalog" "  | Select  ProvisioningSchemeName,  CustomProperties

 <!--NeedCopy-->

Devuelve BillingMode como parte de VMInfo

 -  Get-ProvVMDetails –ProvisioningSchemeName “"MyCatalog" "  | Select-Object  -ExpandProperty VMInfo

 <!--NeedCopy-->

Solución de problemas y validación

MCS incluye comprobaciones previas para evitar configuraciones incompatibles. Puedes encontrar los siguientes errores durante la creación o edición del catálogo:

NoInstanceConfigFoundForBillingMode: Se produce si la oferta de servicio seleccionada (tipo de instancia), la tenencia y el tipo de plataforma no son compatibles con el modo de facturación elegido.
Instancia de Spot no compatible: Si intentas usar instancias de Spot con una conexión de host de WorkSpaces, la validación falla.
Restricción de facturación de EC2: Si tu cuenta de AWS utiliza el modelo de facturación heredado de EC2, intentar establecer un modo de facturación mensual provoca un error de validación.

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

Puedes 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 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, obtendrás un error adecuado.

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.

Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

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

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

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

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

-  New-BrokerCatalog -Name "MPLT1" `

-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-  -ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard

<!--NeedCopy-->

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

Catálogo habilitado para MCSIO

La optimización del almacenamiento de MCS (MCSIO) mejora el rendimiento de la VM al almacenar en caché las operaciones de disco en la memoria o en un disco pequeño de alta velocidad. Puedes crear un catálogo no persistente habilitado para MCSIO mediante comandos de PowerShell. Para crear dicho catálogo, debes instalar el controlador MCSIO al instalar o actualizar el VDA durante la preparación de la instancia de AMI. De forma predeterminada, ese controlador no está instalado.

Una vez preparada una AMI de MCSIO (al instalar el VDA, selecciona la opción de incluir el controlador MCSIO en la instalación), puedes crear un catálogo no persistente habilitado para MCSIO.

Nota:

La opción de configurar MCSIO solo con caché de disco (sin caché de memoria) mediante Studio se ha quitado de todos los hipervisores y entornos de servicio en la nube.

Crea un catálogo habilitado para MCSIO

-  Los cuatro parámetros agregados al comando de PowerShell `New-ProvScheme` son:

-  `UseWriteBackCache`: Activa el almacenamiento en caché (caché de reescritura) para el esquema de aprovisionamiento dado.
-  `WriteBackCacheDiskSize`: Especifica el tamaño en GB del disco temporal usado para el almacenamiento en caché.
-  `WriteBackCacheMemorySize`: Especifica cuánta memoria en MB se debe usar para el almacenamiento en caché. Este es un parámetro opcional.

Nota:

El valor de WriteBackCacheDiskSize debe ser superior a cero, ya que se requiere al menos 1 GB de almacenamiento en disco de caché. El tamaño del disco de caché no debe ser superior al tamaño del disco del SO.

El valor de WriteBackCacheMemorySize debe ser distinto de cero e inferior al tamaño de la memoria del catálogo de máquinas.

Las propiedades personalizadas que afectan a MCSIO son:

WBCDiskStorageType: Define el tipo de volumen, que se usa para el disco temporal en las instancias administradas de Amazon WorkSpaces Core. Este parámetro acepta un argumento de cadena en el formato volume-type[:iops][:throughput]. Los siguientes son los tipos de volumen:
- gp2: No uses los parámetros iops y throughput para este tipo de volumen.
- gp3: Usa los parámetros iops y throughput para este tipo de volumen.
- io1: Usa solo el parámetro iops para este tipo de volumen.
- io2: Usa solo el parámetro iops para este tipo de volumen.
El tipo de volumen predeterminado es gp2.
PersistWBC: Controla si se mantiene o se descarta el disco de caché cada vez que se apaga la instancia administrada de Amazon WorkSpaces Core. Si se establece en true, el disco de caché se mantiene. Si se establece en false (el valor predeterminado), el disco de caché solo se crea y se mantiene mientras la instancia AMI está encendida.
PersistOSDisk: Controla si se mantiene o se descarta el disco del SO cada vez que se apaga la instancia administrada de Amazon WorkSpaces Core. Si se establece en true, el disco del SO se mantiene. Si se establece en false (el valor predeterminado), el disco del SO solo se crea y se mantiene mientras la instancia AMI está encendida.

Realiza los siguientes pasos en la ventana de PowerShell para crear un catálogo no persistente habilitado para MCSIO:

Abre la ventana de PowerShell.
Ejecuta asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
Crea un catálogo de agentes y un grupo de identidades.

Crea el esquema de aprovisionamiento. Por ejemplo:

$HostingUnitUid = '0xxxx1d9-bbfc-xxxf-bxxb-exxxxxe008b2'
$MasterImageVM = 'XDHyp:\HostingUnits\ctx-test\aws-apollo-non-persistent-multi-mcsio-vda-win2022 (ami-0bf1810488acbxxxb).template'
$NetworkMap = @{ 'NetworkPath' = 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\10.0.128.0`/17 (vpc-0fa6e41d72507fxxx).network' }
$SecurityGroup = $( 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\private.securitygroup' )
$ServiceOffering = 'XDHyp:\HostingUnits\ctx-test\T3 Medium Instance.serviceoffering'
$CustomProperties = 'WBCDiskStorageType,gp3:6000:250;PersistWBC,false'

$provScheme = New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
-IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
-  MasterImageVM $MasterImageVM `
-NetworkMap $NetworkMap `
-ServiceOffering $ServiceOffering `
-SecurityGroup $SecurityGroup `
-CustomProperties $CustomProperties `
-UseWriteBackCache -WriteBackCacheDiskSize 16 -WriteBackCacheMemorySize 256

<!--NeedCopy-->

Agrega máquinas virtuales al catálogo.

Mejora el rendimiento de arranque con MCSIO

Puedes mejorar el rendimiento de arranque de las máquinas virtuales si habilitas MCSIO y estableces las propiedades personalizadas PersistWBC y PersistOSDisk en true. Con esta configuración, las máquinas virtuales arrancan más rápido porque no necesitan inicializar un nuevo disco de caché ni volver a crear un disco raíz a partir de su plantilla.

Cifra los discos del SO y de identidad

Puedes crear un catálogo de máquinas virtuales 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.

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

Para cifrar los discos del SO 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

Ten en cuenta 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. Crea una nueva instantánea de ese volumen.
2. Crea un nuevo volumen a partir de esa instantánea.
3. Cifra el nuevo volumen.

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

Crea un catálogo con cifrado de disco

Puedes crear un catálogo de máquinas 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.

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

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 usando la gestió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 existe un perfil de máquina, 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 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 tanto NitroTPM como el arranque seguro en todas las regiones de AWS (incluidas las regiones de AWS GovCloud (US)), 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 catálogo nuevo.

Pasos clave

Configura tu entorno de AWS.
Crea una conexión a AWS.
Crea una imagen maestra (AMI) habilitada con NitroTPM y/o arranque seguro UEFI.
Crea una imagen preparada a partir de la imagen maestra. Consulta Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core.
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 usando comandos de PowerShell.

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

Crear una AMI que admita NitroTPM y el arranque seguro UEFI

Puedes crear una AMI a partir de una máquina virtual 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 máquina virtual.
Usa el comando register-image:
```
--boot-mode (string)
--tpm-support (string)


```
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 una:

oferta de servicio específica 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 del 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 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 máquinas virtuales

Puedes copiar etiquetas en NIC y discos (disco de identidad, disco de caché de escritura 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 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 es aplicable a 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 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 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, entonces la máquina virtual obtiene las etiquetas de ambas interfaces de red.

Filtrar instancias de máquinas virtuales usando 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 listar las instancias de máquina virtual 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. Esto 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 proporcionado 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

 
```

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

 
```
Nota:

Se admiten dos valores de etiqueta. El valor de etiqueta Not Tagged (Sin etiquetar) coincide con los elementos que no tienen la etiqueta dada en su lista de etiquetas. El valor de etiqueta All values (Todos los valores) coincide con los elementos que tienen la etiqueta, independientemente del valor de la etiqueta. De lo contrario, la coincidencia solo ocurre si el elemento tiene la etiqueta y el valor es igual al proporcionado 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 según 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

Administrar catálogos creados con imágenes preparadas

Más información

Administración de imágenes
Para ver ejemplos de PowerShell de GitHub de Amazon WorkSpaces Core, consulta citrix-mcs-sdk-samples-Amazon WorkSpaces Core

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Crear catálogos con imágenes preparadas en instancias administradas de Amazon WorkSpaces Core

May 4, 2026

Contribución de:

May 4, 2026

Contribución de:

En este artículo

Pasos clave
Crear una definición de imagen y una versión inicial de imagen con Studio
Crear una especificación de versión de imagen preparada con PowerShell
Compartir imágenes preparadas entre zonas de disponibilidad y regiones
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
Facturación flexible
Crear un catálogo
Crear un catálogo usando Studio
Crear un catálogo con PowerShell
Catálogo habilitado para MCSIO
Cifra los discos del SO y de identidad
Habilitar NitroTPM y el arranque seguro UEFI para instancias de máquinas virtuales
Copiar etiquetas en máquinas virtuales
Filtrar instancias de máquinas virtuales usando PowerShell
Pasos siguientes
Más información

¿Le ha resultado útil?