Documentación de productos
Citrix Virtual Apps and Desktops
Servicio Versión actual 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Administrar catálogos de máquinas de imagen preparada

May 31, 2026
Contribución de: 
C

Puede actualizar un catálogo de máquinas MCS existente con una imagen preparada diferente y administrar las definiciones y versiones de la imagen mediante:

Usar Web Studio

Actualizar un catálogo de máquinas con una imagen preparada diferente

Para actualizar un catálogo de máquinas MCS existente con una imagen preparada diferente, haga lo siguiente:

  1. Haga clic en Catálogos de máquinas en el panel de navegación izquierdo y seleccione el catálogo de máquinas que quiera actualizar. Haga clic con el botón secundario y seleccione Cambiar imagen preparada.

  2. En la página Imagen, seleccione una imagen preparada. Si es necesario, agregue una nota para la imagen preparada seleccionada.

    Nota:

    Aplicable a Azure: También puede elegir una imagen con ACG no habilitado y, más tarde, seleccionar la casilla Colocar la imagen preparada en Azure Compute Gallery para colocar las imágenes en la galería.

  3. Para revertir a una imagen preparada asignada anteriormente, haga clic en Usar la asignación de imagen anterior para una reversión rápida en la parte inferior del asistente.

    Se abre una nueva ventana que muestra una lista de todas las asignaciones de imágenes históricas disponibles. Al seleccionar una imagen de la lista, la versión correspondiente se selecciona automáticamente en el árbol de imágenes preparadas de la página de la imagen.

  4. En la página Estrategia de implementación, seleccione cuándo quiere actualizar este catálogo con la imagen preparada seleccionada.
  5. En la página Resumen, compruebe los detalles. Haga clic en Finalizar.

Puede ver el historial de cambios de imagen realizados en un catálogo. Para ver el historial, haga lo siguiente:

  1. Seleccione un catálogo de máquinas.
  2. En la ficha Propiedades de la plantilla, en el campo Imagen preparada, haga clic en Ver historial de imágenes.

Administrar las definiciones y versiones de imágenes

Puede editar y eliminar las definiciones y versiones de imágenes para administrar el uso de las distintas versiones y definiciones de imágenes creadas.

Editar una definición de imagen

Puede editar el nombre y la descripción de una definición de imagen.

Para editar una definición de imagen, haga lo siguiente:

  1. Vaya al nodo Imágenes, seleccione una definición de imagen y seleccione Editar definición de imagen.

Editar versión de imagen

Puede editar la descripción de una versión de imagen para especificar el propósito de esa versión de imagen.

Para editar una versión de imagen, haga lo siguiente:

  1. Vaya al nodo Imágenes, seleccione una versión de imagen y seleccione Editar descripción.

Eliminar una versión de imagen

Para eliminar una versión de imagen, haga lo siguiente:

  1. Vaya al nodo Imágenes, seleccione una versión de imagen y seleccione Eliminar versión de imagen.

Nota:

No puede eliminar una versión de imagen si la utiliza un catálogo de máquinas.

Eliminar una definición de imagen

Para eliminar una definición de imagen, haga lo siguiente:

  1. Vaya al nodo Imágenes, seleccione una definición de imagen y seleccione Eliminar definición de imagen.

Nota:

No puede eliminar una definición de imagen si contiene una versión de imagen.

Usar PowerShell

Actualizar un catálogo mediante una especificación de versión de imagen preparada

Puede actualizar un catálogo mediante el comando Set-ProvSchemeImage. Por ejemplo,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

O bien,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell para actualizar un catálogo:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

Obtener el historial de cambios de imagen para el esquema de aprovisionamiento 

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

Eliminar definición de imagen, versión de imagen y especificación de versión de imagen preparada

Tenga en cuenta lo siguiente antes de eliminar una definición de imagen, una versión de imagen y una especificación de versión de imagen preparada:

  • Una definición de imagen no se puede eliminar si contiene alguna versión de imagen.
  • Una versión de imagen no se puede eliminar si contiene alguna especificación de versión de imagen.
  • Una especificación de versión de imagen maestra no se puede eliminar si la utiliza cualquier otra especificación de versión de imagen preparada.
  • Una especificación de versión de imagen preparada no se puede eliminar si la utiliza algún catálogo de máquinas MCS.
  • Una unidad de alojamiento no se puede eliminar si la utiliza cualquier otra especificación de versión de imagen preparada.

Los pasos detallados son los siguientes:

  1. Elimine el catálogo de máquinas. Por ejemplo,

    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
<!--NeedCopy-->

  2. Elimine la especificación de versión de imagen preparada compartida. Por ejemplo,

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->

  3. Elimine una especificación de versión de imagen preparada. Por ejemplo,

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
<!--NeedCopy-->

  4. Elimine la especificación de versión de imagen maestra. Por ejemplo,

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
<!--NeedCopy-->

    Nota:

    La especificación de versión de imagen maestra solo se puede eliminar cuando no hay ninguna especificación de versión de imagen preparada asociada.

  5. Elimine una versión de imagen. Por ejemplo,

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  6. Elimine la configuración de la definición de imagen en la conexión de alojamiento especificada. Por ejemplo,

    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
<!--NeedCopy-->

  7. Eliminar una definición de imagen. Por ejemplo:

    Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell cuando la imagen preparada no se comparte entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell cuando la imagen preparada se comparte entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid>
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Administrar la definición y la versión de la imagen

Puede cambiar el nombre y editar una definición de imagen, y editar una versión de imagen.

  • Cambie el nombre de una definición de imagen con el comando Rename-ProvImageDefinition. Por ejemplo:

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
 <!--NeedCopy-->

    O bien,

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
 <!--NeedCopy-->

  • Edite una definición de imagen con el comando Set-ProvImageDefinition. Por ejemplo:

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    O bien,

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
 <!--NeedCopy-->

  • Edite una versión de imagen con el comando Set-ProvImageVersion. Por ejemplo:

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
 <!--NeedCopy-->

    O bien,

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
 <!--NeedCopy-->

Obtener la definición de imagen, la versión de imagen, la especificación de la versión de imagen preparada y los detalles del esquema de aprovisionamiento

  • Obtenga los detalles de la definición de imagen con el comando Get-ProvImageDefinition. Por ejemplo:

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
 <!--NeedCopy-->

  • Obtenga los detalles de la versión de imagen con el comando Get-ProvImageVersion. Por ejemplo:

    • Para enumerar las versiones de imagen en una definición de imagen,

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
 <!--NeedCopy-->

      O bien,

       Get-ProvImageVersion -ImageDefinitionName <string>
 <!--NeedCopy-->

    • Para obtener los detalles de una versión de imagen,

       Get-ProvImageVersion -ImageVersionUid <Guid>
 <!--NeedCopy-->

      O bien,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
 <!--NeedCopy-->

  • Obtenga la especificación de la versión de imagen preparada mediante el comando Get-ProvImageVersionSpec. Por ejemplo:

    • Para enumerar todas las especificaciones de la versión de imagen preparada en una versión de imagen,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 <!--NeedCopy-->

    • Para enumerar las especificaciones de la versión de imagen maestra en una especificación de versión de imagen preparada,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 <!--NeedCopy-->

    • Para enumerar las especificaciones de la versión de imagen preparada en una versión de imagen, que está asociada a una imagen maestra,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
 <!--NeedCopy-->

    • Para obtener las especificaciones de la versión de imagen preparada correctas en una versión de imagen,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
 <!--NeedCopy-->

    • Para obtener los detalles de una especificación de versión de imagen preparada,

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 <!--NeedCopy-->

  • Obtenga los detalles del esquema de aprovisionamiento mediante el comando Get-ProvScheme. Por ejemplo:

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

  • Obtenga el historial de especificaciones de la versión de imagen preparada de un esquema de aprovisionamiento mediante el comando Get-ProvSchemeImageVersionSpecHistory. Por ejemplo:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
 <!--NeedCopy-->

Más información

Administrar catálogos de máquinas de imagen preparada
May 31, 2026
Contribución de: 
C
May 31, 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.