Documentación de productos
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core

July 9, 2026
Contribución de: 
C

Cree imágenes preparadas para crear un catálogo de máquinas MCS. Puede crear imágenes preparadas mediante:

Pasos clave

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

Usar Web Studio

Crear una definición de imagen y una versión inicial de la imagen

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

  1. En Web Studio, vaya al nodo Imágenes y haga clic en Crear definición de imagen. Haga clic en Siguiente en la página Introducción.
  2. En la página Definición de imagen, especifique el tipo de SO y el tipo de sesión para la definición de imagen.

  3. En la página Imagen, seleccione 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. Seleccione 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, verifique que la imagen maestra tenga instalado VDA 2311 o posterior y que el controlador MCSIO esté instalado en el VDA.
    • El Servicio de metadatos de instancia (IMDS) V2 es el único compatible, no el IMDS V1. Para obtener más información, consulte Cómo funciona el Servicio de metadatos de instancia versión 2.
  4. En la página Especificación de la máquina, seleccione 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 NICs, seleccione o añada NIC para la imagen de preparación. Para cada NIC, seleccione una subred de VPC asociada.
  6. En la página Descripción de la versión, introduzca una descripción para la versión inicial de la imagen creada.
  7. En la página Resumen, compruebe los detalles de la definición de la imagen y la versión inicial de la imagen creada. Introduzca un nombre y una descripción para la definición de la imagen. Haga clic en Finalizar.

Crear versiones de imagen

Las versiones de imagen permiten la gestión de diferentes iteraciones o actualizaciones de una imagen en particular. Esta funcionalidad le 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, haga lo siguiente:

Nota:

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

  1. Vaya al nodo Imágenes, seleccione una versión de imagen o una definición de imagen y haga clic en Crear versión de imagen.
  2. En la página Definición de imagen, puede 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 desea que la configuración de la versión de imagen sea diferente de la versión de imagen configurada inicialmente, configure los ajustes en las páginas Especificación de la máquina y NICs del cuadro de diálogo Crear versión de imagen.
  4. Añada una descripción para la versión de imagen. Haga clic en Finalizar.

Nota:

Si la creación de la versión de la imagen falla por cualquier motivo, la pestaña Solucionar problemas en la parte inferior proporciona una opción de Reintentar.

Usar PowerShell

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

  1. Compruebe los nombres de definición de imagen disponibles usando Test-ProvImageDefinitionNameAvailable command. Por ejemplo,

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

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

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

  3. Cree 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. Cree una versión de imagen usando el comando New-ProvImageVersion. Por ejemplo,

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

  5. Agregue 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:

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

  6. Cree 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 la definición de imagen, la versión de imagen y la 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 la versión de la imagen deben tener un perfil de máquina.

Compartir imágenes preparadas entre zonas de disponibilidad y regiones

Ahora puede 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 sus instancias administradas de Amazon WorkSpaces Core. Esto le 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 diferentes regiones, la versión de la imagen preparada se copia de la región original a las regiones de destino.

Puede 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 puede 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: Usted crea una imagen preparada en una zona de disponibilidad (por ejemplo, us-east-1a). Luego puede 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 usted.
  • Creación y actualización eficiente de catálogos: Puede 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), puede usar la imagen compartida en AZ 2 para crear y actualizar catálogos en AZ 2.
  • Implementaciones de unidades de alojamiento y conexiones de alojamiento cruzadas: Si su entorno tiene múltiples unidades de alojamiento bajo la misma o diferente región y cuenta de AWS, puede compartir eficientemente imágenes preparadas entre estas unidades de alojamiento.

Limitaciones

  • Compartir dentro de la misma cuenta de AWS: No puede 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 debe eliminar todas sus especificaciones de versión de imagen compartidas. Alternativamente, debe eliminar las especificaciones originales y compartidas simultáneamente.
  • Retrocompatibilidad del catálogo: Puede actualizar los catálogos de máquinas existentes que implementó antes de la introducción de esta función. Utilice imágenes preparadas que haya creado en una zona de disponibilidad o región diferente de donde implementó originalmente el catálogo.
  • Eliminación completa: Cuando elimina una imagen preparada, ya no puede usarla en ninguna zona de disponibilidad donde la compartió o la creó originalmente. Además, una versión de imagen preparada no se puede eliminar hasta que se eliminen primero todos los catálogos vinculados a la versión de la imagen preparada.

Requisitos previos

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

  • Su entorno debe ser un entorno de instancias administradas de Amazon WorkSpaces Core.
  • Debe 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) en la misma cuenta de AWS.

Configurar mediante la interfaz de usuario de Web Studio

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

Para compartir una imagen preparada

  1. Vaya al nodo Imágenes de Web Studio y seleccione la versión de imagen preparada que desea compartir con otras zonas de disponibilidad.
  2. Seleccione Administrar uso compartido de imágenes en la barra de navegación superior para administrar el uso compartido de imágenes para la versión de imagen seleccionada.
  3. En la página Administrar uso compartido de imágenes, seleccione uno o varios recursos con los que desea 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.
  4. Haga 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 forma que se comparte entre los diferentes recursos que seleccionó. Una vez completado, utilice 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 dejar de compartir una imagen preparada

  1. En el nodo Imágenes de Web Studio, seleccione la versión de imagen preparada que desea dejar de compartir.
  2. Seleccione Administrar uso compartido de imágenes en la barra de navegación superior para administrar el uso compartido de imágenes para la versión de imagen seleccionada.

  3. Desactive las casillas de verificación de uno o varios recursos (zonas de disponibilidad) con los que desea dejar de compartir la versión de la imagen.

    Nota:

    Los recursos ya no deben tener catálogos asociados ni creados 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 eliminar debe suprimirse primero.

  4. Haga clic en Guardar para dejar de compartir los recursos en las zonas de disponibilidad borradas. La versión de la imagen se actualiza de modo que ya no se comparte en esas zonas de disponibilidad.

Configurar mediante PowerShell

Alternativamente, puede 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úrese de tener el ImageVersionSpecUid de la imagen preparada que desea compartir. Puede recuperarlo mediante Get-ProvImageVersionSpec o comandos Get- similares en PowerShell.
  2. Determine el HostingUnitName de la zona de disponibilidad (puede ser la misma región o una diferente) donde desea que la imagen preparada esté disponible. Este es el nombre de la unidad de alojamiento que configuró para esa AZ específica.

  3. Ejecute el comando Add-ProvImageVersionSpecHostingUnit: Utilice el siguiente comando de PowerShell. Reemplace <ImageVersionSpecUid> por el Uid de su imagen y <targetHostingUnitName> por el nombre de la unidad de alojamiento en la zona de disponibilidad de destino a la que desea compartir la especificación de la versión de la imagen:

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->
  4. Después de una ejecución correcta, puede ver el estado de la imagen en la interfaz de usuario de Web Studio, lo que indica que la ha compartido con la unidad de alojamiento especificada.

Para dejar de compartir una imagen preparada

  1. Asegúrese de tener el ImageVersionSpecUid de la imagen preparada de la que desea dejar de compartir.
  2. Determine el HostingUnitName de la zona de disponibilidad de la que desea eliminar la imagen compartida.

  3. Ejecute el comando Remove-ProvImageVersionSpecHostingUnit: Utilice el siguiente comando de PowerShell. Reemplace <ImageVersionSpecUid> por el Uid de su imagen y <targetHostingUnitName> por el nombre de la unidad de alojamiento en la zona de disponibilidad de destino de la que desea eliminar el uso compartido de la especificación de la versión de la imagen:

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

A dónde ir a continuación

Más información

Crear una imagen preparada para instancias administradas de Amazon WorkSpaces Core
July 9, 2026
Contribución de: 
C
July 9, 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.