Documentación de productos
Citrix DaaS™
Ver PDF

Crea una imagen preparada para instancias administradas de Amazon WorkSpaces Core

March 25, 2026
Contribución de: 
C

Crea imágenes preparadas para crear un catálogo de máquinas MCS. Puedes crear imágenes preparadas usando:

Pasos clave

  1. Crea la definición de imagen y las versiones de imagen iniciales.
  2. Crea versiones de imagen a partir de la versión de imagen inicial.

Usa Studio

Crea una definición de imagen y una versión de imagen inicial

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

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

  3. 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 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 el Servicio de metadatos de instancia versión 2.
  4. 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.
  5. En la página NIC, selecciona o agrega NIC para la imagen de preparación. Para cada NIC, selecciona una subred de VPC asociada.
  6. En la página Descripción de la versión, introduce una descripción para la versión de imagen inicial creada.
  7. En la página Resumen, verifica los detalles de la definición de imagen y la versión de imagen inicial creada. Introduce un nombre y una descripción para la definición de imagen. Haz clic en Finalizar.

Crea versiones de imagen

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 de imagen inicial, haz lo siguiente:

Nota:

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

  1. 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.
  2. 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.
  3. 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.
  4. 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 cualquier motivo, la ficha Solucionar problemas en la parte inferior proporciona una opción Reintentar.

Usa PowerShell

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

  1. Comprueba los nombres de definición de imagen disponibles usando el comando Test-ProvImageDefinitionNameAvailable. Por ejemplo,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

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

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Crea una nueva configuración para la definición de imagen en la conexión de alojamiento especificada usando el comando Add-ProvImageDefinitionConnection.

    Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
<!--NeedCopy-->

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

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  5. Agrega una especificación de versión de imagen maestra a la versión de imagen usando el comando Add-ProvImageVersionSpec. Por ejemplo,

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"
<!--NeedCopy-->

    Nota:

    Puedes agregar solo una especificación de versión de imagen maestra a una versión de imagen para una unidad de alojamiento.

  6. Crea una especificación de versión de imagen preparada a partir de la especificación de versión de imagen maestra usando 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 distintas 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 administración de imágenes, garantiza la coherencia en las implementaciones y agiliza el proceso de aprovisionamiento. También puedes actualizar sin problemas los catálogos de máquinas existentes con imágenes preparadas de una zona de disponibilidad o región diferente.

Casos de uso

  • Administració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 eficientes de catálogos: Puedes usar una imagen preparada creada en AZ 1 (por ejemplo, us-east-1a) para crear nuevos catálogos en AZ 1. Después de compartir esta imagen con AZ 2 (por ejemplo, us-east-1b), puedes usar la imagen compartida en AZ 2 para crear y actualizar catálogos en AZ 2.
  • Implementaciones entre unidades de alojamiento y conexiones de alojamiento: Si tu entorno tiene varias unidades de alojamiento en la misma o en 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.
  • Compatibilidad con versiones anteriores del catálogo: Puedes actualizar los 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 varias 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 mediante la interfaz de usuario de Studio

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

Para compartir una imagen preparada

  1. Navega al nodo Imágenes de Studio y selecciona la versión de imagen preparada que quieres compartir con otras zonas de disponibilidad.
  2. Selecciona Administrar uso compartido de imágenes en la barra de navegación superior para administrar el uso compartido de la versión de imagen seleccionada.
  3. 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 imagen. Los recursos pueden estar en zonas de disponibilidad diferentes a las de la versión de imagen original.
  4. Haz clic en Guardar para compartir la versión de imagen en los recursos de otras zonas de disponibilidad. La versión de imagen se actualiza de modo que se comparte entre los diferentes recursos que seleccionaste. Una vez completado, usa la versión de imagen para crear catálogos en las zonas de disponibilidad en las que se comparte la versión de imagen.

Para quitar el uso compartido de una imagen preparada

  1. En el nodo Imágenes de Studio, selecciona la versión de imagen preparada de la que quieres quitar el uso compartido.
  2. Selecciona Administrar uso compartido de imágenes en la barra de navegación superior para administrar el uso compartido de la versión de imagen seleccionada.

  3. Desmarca las casillas de uno o más recursos (zonas de disponibilidad) con los que quieres dejar de compartir la versión de 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.

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

Configurar mediante PowerShell

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

Para compartir una imagen preparada

  1. Asegúrate de tener el ImageVersionSpecUid de la imagen preparada que quieres compartir. Puedes recuperarlo usando Get-ProvImageVersionSpec o comandos Get- similares en PowerShell.
  2. 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.

  3. 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 imagen:

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->
  4. 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

  1. Asegúrate de tener el ImageVersionSpecUid de la imagen preparada de la que quieres quitar el uso compartido.
  2. Determina el HostingUnitName de la zona de disponibilidad de la que quieres quitar la imagen compartida.

  3. 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 imagen:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->

Qué hacer a continuación

Más información

Crea una imagen preparada para instancias administradas de Amazon WorkSpaces Core
March 25, 2026
Contribución de: 
C
March 25, 2026
Contribución de: 
C

En este artículo

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