Citrix DaaS

Administrar catálogos de máquinas de imágenes preparadas

September 15, 2025

Contribución de:

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

Studio
PowerShell

Usar Studio

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

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

Haga clic en Catálogos de máquinas en el panel de navegación izquierdo y seleccione el catálogo de máquinas que quiere actualizar. Haga clic con el botón secundario y seleccione Cambiar imagen preparada.
En la página Imagen, seleccione una imagen preparada.

Nota: No

Aplicable a Azure: también puede elegir una imagen con ACG no habilitada y, más adelante, seleccionar la casilla Colocar la imagen preparada en Azure Compute Gallery para colocar las imágenes en la galería.
En la página Estrategia de implantación, seleccione cuándo quiere actualizar este catálogo con la imagen preparada seleccionada.
En la página Resumen, compruebe los detalles. Haga clic en Finish.

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

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

Administrar las definiciones y versiones de las imágenes

Puede modificar y eliminar las definiciones y versiones de las distintas imágenes creadas.

Modificar una definición de imagen

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

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

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

Modificar una versión de imagen

Puede modificar la descripción de una versión de imagen para especificar su propósito.

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

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

Eliminar una versión de imagen

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

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

Nota: No

No se puede eliminar una versión de imagen si se usa en un catálogo de máquinas.

Eliminar una definición de imagen

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

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

Nota: No

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 con el comando Set-ProvSchemeImage. Por ejemplo:

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

Or,

  Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--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
<!--NeedCopy-->

Eliminar la 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, versión de imagen y especificación de versión de imagen preparada:

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

Estos son los pasos detallados:

Quite el catálogo de máquinas. Por ejemplo:

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

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

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

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

Quite 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: No

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

Quite una versión de imagen. Por ejemplo:

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

Quite la configuración de la definición de imagen en la conexión de host especificada. Por ejemplo:

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

Quite 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 en la unidad 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 comandos de PowerShell cuando la imagen preparada se comparte en la unidad 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 la definición y la versión de imagen

Puede cambiar el nombre de una definición de imagen y modificarla. También puede modificar una versión de imagen.

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

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

Or,

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

Modifique una definición de imagen usando el comando Set-ProvImageDefinition. Por ejemplo:

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

Or,

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

Modifique una versión de imagen usando el comando Set-ProvImageVersion. Por ejemplo:

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

Or,

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

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

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

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

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

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

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

Or,

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

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

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

Or,

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

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

Para enumerar todas las especificaciones de versión de imagen preparada de una versión de imagen,
```
   Get-ProvImageVersionSpec -ImageVersionUid <Guid>
 
```
Para enumerar las especificaciones de versión de imagen maestra de una especificación de versión de imagen preparada,
```
   Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 
```

Para enumerar las especificaciones de versión de imagen preparada de 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 correctamente las especificaciones de versión de imagen preparada de 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 la especificación de versión de imagen preparada,
```
   Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
 
```

Obtenga 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 versión de la imagen preparada de un esquema de aprovisionamiento con 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

Gestión de imágenes

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?

Administrar catálogos de máquinas de imágenes preparadas

September 15, 2025

Contribución de:

September 15, 2025

Contribución de:

¿Le ha resultado útil?