Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Administrar catálogos de máquinas con imagen preparada

April 6, 2026
Contribución de: 
C

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

  • Web Studio
  • PowerShell

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

  1. Haz clic en Catálogos de máquinas en el panel de navegación izquierdo y selecciona un catálogo de máquinas que quieras actualizar. Haz clic con el botón derecho y selecciona Cambiar imagen preparada.

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

    Nota:

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

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

    Se abre una nueva ventana y muestra una lista de todas las asignaciones de imagen históricas disponibles. Cuando seleccionas 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 imagen.

  4. En la página Estrategia de implementación, selecciona cuándo quieres actualizar este catálogo con la imagen preparada seleccionada.
  5. En la página Resumen, comprueba los detalles. Haz clic en Finalizar.

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

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

Administrar las definiciones y versiones de imagen

Puedes modificar y quitar las definiciones y versiones de imagen para administrar el uso de varias versiones y definiciones de imagen creadas.

Modificar una definición de imagen

Puedes modificar el nombre y la descripción de una definición de imagen.

Para modificar una definición de imagen, haz lo siguiente:

  1. Ve al nodo Imágenes, selecciona una definición de imagen y selecciona Modificar definición de imagen.

Modificar versión de imagen

Puedes modificar la descripción de una versión de imagen para especificar el propósito de esa versión de imagen.

Para modificar una versión de imagen, haz lo siguiente:

  1. Ve al nodo Imágenes, selecciona una versión de imagen y selecciona Modificar descripción.

Quitar una versión de imagen

Para quitar una versión de imagen, haz lo siguiente:

  1. Ve al nodo Imágenes, selecciona una versión de imagen y selecciona Quitar versión de imagen.

Nota:

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

  • Quitar una definición de imagen

  • Para quitar una definición de imagen, haz lo siguiente:

    1. Ve al nodo Imágenes, selecciona una definición de imagen y selecciona Quitar definición de imagen.

Nota:

No puedes quitar 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

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

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

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

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

Los pasos detallados son los siguientes:

  1. Quita el catálogo de máquinas. Por ejemplo:

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

  2. Quita la especificación de versión de imagen preparada compartida. Por ejemplo:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
<!--NeedCopy-->
    1. Quita 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-->
      1. Quita 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:

      Solo se puede quitar la especificación de versión de imagen maestra cuando no hay ninguna especificación de versión de imagen preparada asociada.

  1. Quita una versión de imagen. Por ejemplo:

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

  2. Quita la configuración de la definición de imagen en la conexión de alojamiento especificada. Por ejemplo:

    ```

  • Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

    ```

  1. Quita 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 alojamiento:
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 PowerShell cuando la imagen preparada se comparte entre unidades de alojamiento:

    -  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 definición de imagen y versión de imagen

Puedes cambiar el nombre y modificar una definición de imagen, y modificar una versión de imagen.

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

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

    O bien,

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

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

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

    O bien,

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

  • Modifica una versión de imagen mediante 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 detalles de la definición de imagen, la versión de imagen, la especificación de versión de imagen preparada y el esquema de aprovisionamiento

  • Obtén los detalles de la definición de imagen mediante el comando Get-ProvImageDefinition. Por ejemplo:

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

  • Obtén los detalles de la versión de imagen mediante 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 un detalle de la versión de imagen:

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

      O bien,

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

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

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

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

    • Para enumerar las especificaciones de 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 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 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 un detalle de la especificación de versión de imagen preparada:

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

  • Obtén 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-->

  • Obtén el historial de especificaciones de 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 con imagen preparada
April 6, 2026
Contribución de: 
C
April 6, 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.