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

Administración de imágenes (Technical Preview)

September 13, 2024
Contribución de: 
C

Introducción

El proceso de creación o actualización de catálogos de MCS tiene dos fases:

  • Masterización: Una imagen fuente se convierte en una imagen publicada
  • Clonación: Se crean nuevas máquinas virtuales a partir de la imagen publicada

Con la funcionalidad de administración de imágenes, MCS separa la fase de masterización del flujo de trabajo general de aprovisionamiento.

Puede preparar varias versiones de imágenes de MCS (imagen preparada) a partir de una única imagen de origen y usarla en varios catálogos de máquinas de MCS diferentes. Esta implementación reduce significativamente los costes de almacenamiento y tiempo, y simplifica el proceso de implementación de máquinas virtuales y actualización de imágenes.

Las ventajas de usar esta funcionalidad de administración de imágenes son:

  • Genere imágenes preparadas por adelantado sin crear un catálogo.
  • Reutilice las imágenes preparadas en diferentes escenarios, como crear y actualizar un catálogo.
  • Reduzca considerablemente el tiempo de creación o actualización de catálogos.

Nota:

  • Esta función se aplica actualmente a los entornos de virtualización de Azure y VMware.
  • Puede crear un catálogo de máquinas MCS sin usar imágenes preparadas. En ese caso, no podrá aprovechar las ventajas de la función.

Casos de uso

Algunos de los casos de uso de la funcionalidad de administración de imágenes son:

  • Administración de versiones: Las versiones de imágenes le permiten:

    • administrar diferentes iteraciones o actualizaciones de una imagen en particular.
    • mantener varias versiones de una imagen para diferentes fines.

  • Agrupación lógica: Puede crear varias definiciones de imágenes para:

    • agrupar lógicamente las versiones de las imágenes en función de diversos criterios, como el proyecto, el departamento o el tipo de aplicación y escritorio.
    • administrar las imágenes de manera más eficiente dentro de una organización.

¿Qué es una imagen preparada?

Con la funcionalidad de administración de imágenes, MCS desvincula la fase de masterización del flujo de trabajo general de creación o actualización del catálogo y divide el proceso en dos etapas:

  1. Crear imágenes preparadas a partir de una única imagen fuente.
  2. Usar la imagen preparada para crear o actualizar un catálogo de máquinas de MCS.

Puede crear las imágenes preparadas por adelantado. Puede usar una sola imagen preparada para crear o actualizar varios catálogos de máquinas aprovisionadas por MCS.

Explicación de cómo se usa una imagen preparada en varios catálogos de máquinas de MCS cuando usa Web Studio desde la imagen:

Descripción general de la imagen preparada

Definición de imagen: Las definiciones de imagen son una agrupación lógica de versiones de una imagen. La definición de la imagen contiene información sobre:

  • por qué se creó la imagen
  • para qué sistema operativo es
  • otra información sobre el uso de la imagen.

Un catálogo no se crea a partir de una definición de imagen, sino a partir de las versiones de imagen que se crean en función de la definición de imagen.

Versión de imagen: Las versiones de una imagen administran el control de versiones de la definición de imagen. Una definición de imagen puede tener varias versiones de imagen. Use las versiones de las imágenes como imágenes preparadas para crear o actualizar un catálogo.

Como alternativa, si quiere usar los comandos de PowerShell para crear un esquema de aprovisionamiento para crear o actualizar un catálogo, debe crear una especificación de versión de imagen preparada basada en la especificación de versión de la imagen maestra, según sea necesario para su entorno.

Participar en Tech Preview

Si está interesado en participar en Tech Preview, proporcione su información de contacto aquí.

Le ayudaremos a configurar el entorno de prueba y le proporcionaremos asistencia técnica si es necesario.

Requisito

  • Para la imagen maestra de Windows, solo se admiten imágenes de VDA con la versión 2311 y posteriores y con E/S de MCS habilitada.

Limitaciones

Actualmente, la función no admite lo siguiente:

  • Varias NIC en Azure
  • Funcionalidad de disco de datos persistente
  • Hibernación para multisesión
  • Cambio del tipo de imagen

Administración del ciclo de vida de las imágenes mediante Web Studio

El ciclo de vida de la imagen cuando usa Web Studio es:

  1. Crear una imagen preparada: Crear una definición de imagen y su versión de imagen inicial.
  2. Crear versiones de la imagen a partir de la versión de imagen inicial.
  3. Usar una versión de imagen como imagen preparada para crear catálogos.
  4. Actualizar un catálogo de máquinas con una imagen preparada diferente.
  5. Administrar las definiciones y versiones de las imágenes: Modificar el nombre y la descripción de las versiones de las imágenes y la descripción de una definición de imagen.
  6. Eliminar una versión de imagen.
  7. Eliminar una definición de imagen.

Como alternativa, también puede administrar imágenes mediante PowerShell. Consulte Administración del ciclo de vida de las imágenes mediante PowerShell.

Crear o actualizar un catálogo mediante una imagen preparada

Cree imágenes preparadas y úselas para crear o actualizar un catálogo de máquinas de MCS mediante:

Usar Web Studio

Consulte los siguientes temas:

Explicación del nodo Imágenes

Use el nodo Imágenes para crear y administrar imágenes preparadas de MCS. Su vista principal se divide en cuatro partes:

vista-principal-nodo-imágenes

Etiqueta Parte Descripción
A Definiciones de imágenes Muestra las definiciones de imagen creadas anteriormente.
B Versiones de imágenes Muestra las versiones de imagen de la definición de imagen seleccionada.
C


Detalles


  • La ficha Detalles muestra información detallada sobre la definición o versión de la imagen seleccionada, como la imagen maestra, el recurso, el hipervisor, el nombre de la definición de imagen, el tipo de sistema operativo y el tipo de sesión.
  • La ficha Esquema de imagen muestra información sobre la plantilla usada para preparar las imágenes, como el disco duro, el tamaño de la máquina, el tipo de licencia, el conjunto de cifrado del disco, el perfil de máquina, etc.
  • La ficha Esquemas de aprovisionamiento muestra el nombre del esquema de aprovisionamiento usado para crear el catálogo.
  • La ficha Solución de problemas proporciona el estado del error de la versión de imagen seleccionada.
D Barra de acciones Enumera las acciones que puede realizar en las definiciones y versiones de imágenes, como Crear versión de imagen, Modificar descripción, Eliminar versión de imageny Crear catálogo.

Crear un catálogo de máquinas con la imagen preparada

Los pasos clave para crear un catálogo de máquinas MCS con la imagen preparada son:

  1. Crear la definición de la imagen y las versiones iniciales de la imagen.
  2. Usar la versión de imagen como una imagen preparada para crear un catálogo.

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

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

  1. Inicie sesión en Web Studio y seleccione el nodo Imágenes. En la página Introducción, haga clic en Siguiente.
  2. En la página Definición de imagen, especifique el tipo de sistema operativo y el tipo de sesión para la definición de la imagen.

  3. En la página Imagen, seleccione Recursos y una imagen maestra para usarla como plantilla para crear la versión de imagen. Puede seleccionar la casilla Usar un perfil de máquina para seleccionar uno.

    Nota:

    Antes de seleccionar una imagen, verifique que la imagen maestra tenga instalado el VDA 2311 o una versión posterior y que el controlador de E/S de MCS esté instalado en el VDA.

  4. (Solo para Azure) En la página Tipos de licencia y almacenamiento, seleccione el tipo de almacenamiento y licencia que se usará como parte del proceso de preparación de la imagen.

    Nota:

    Si selecciona un perfil de máquina en la página Imagen, el tipo de licencia del perfil de máquina se preselecciona en función de la configuración del perfil.

  5. En la página Especificación de máquina:

    • Para Azure, seleccione un tamaño de máquina. Si selecciona un perfil de máquina en la página Imagen, se selecciona de forma predeterminada el tamaño de máquina del perfil de máquina.
    • En el caso de VMware, si selecciona un perfil de máquina, puede ver el recuento de CPU virtual derivado del perfil de máquina y no se puede cambiar. Si no selecciona un perfil de máquina, solo podrá ver el tamaño de memoria que se deriva de la imagen maestra.

  6. En la página Tarjetas NIC, seleccione o agregue tarjetas NIC para la imagen de preparación. Para cada tarjeta NIC, seleccione una red virtual asociada.

    Para VMware, si no selecciona un perfil de máquina, se selecciona de forma predeterminada la tarjeta NIC asociada a la imagen maestra. Si selecciona un perfil de máquina, las tarjetas NIC se derivan del perfil de máquina y el recuento no se puede cambiar.

    Nota:

    Azure no admite varias tarjetas NIC.

  7. (Solo para Azure) En la página Parámetros del disco, seleccione la clave de cifrado administrada por el cliente (CMEK). Si el perfil de la máquina no tiene una CMEK, pero la imagen maestra sí, preselecciona la CMEK de la imagen maestra.
  8. En la página Descripción de la versión, introduzca una descripción para la versión de imagen inicial creada.
  9. En la página Resumen, compruebe los detalles de la definición de imagen y la versión inicial de la imagen creada. Introduzca un nombre y una descripción para la definición de imagen. Haga clic en Finalizar.

Crear versiones de imágenes

Las versiones de imagen permiten administrar diferentes iteraciones o actualizaciones de una imagen en particular. Esta funcionalidad le permite mantener varias versiones de una imagen para diferentes fines.

Para crear versiones de imagen a partir de la versión de imagen inicial, haga lo siguiente:

Nota:

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

  1. Vaya al nodo Imágenes, seleccione una versión de imagen y seleccione Crear versión de imagen.
  2. Si quiere que la configuración de la versión de imagen sea diferente de la versión de imagen configurada inicialmente, configure los parámetros de las páginas Imagen, Tipos de licencia y almacenamiento, Especificaciones de la máquina, Tarjetas NIC y Parámetros del disco del cuadro de diálogo Crear versión de imagen.
  3. Agregue una descripción para la versión de la imagen. Haga clic en Finalizar.

crear-versiones-imagen

Crear un catálogo de máquinas desde el nodo Imágenes

Use la opción Crear catálogo del nodo Imágenes para crear un catálogo con la versión de la imagen.

Como alternativa, puede seleccionar la versión al crear un catálogo en el nodo Catálogos de máquinas y vincularla a la opción de imagen preparada en el flujo de trabajo de creación del catálogo. Consulte Crear un catálogo de máquinas desde el nodo Catálogos de máquinas

Para crear un catálogo de máquinas de MCS desde el nodo Imágenes, haga lo siguiente:

  1. Seleccione una versión de imagen y haga clic en Crear catálogo. En la página Introducción, haga clic en Siguiente.
  2. En la página Experiencia de escritorio, seleccione la experiencia de escritorio requerida.
  3. Desde la página Imagen hasta la página Parámetros del disco, los parámetros se preseleccionan en función de la versión de imagen seleccionada.
  4. (Para Azure) En la página Grupo de recursos, puede optar por crear un nuevo grupo de recursos o usar un grupo de recursos existente para colocar los recursos de este catálogo.
  5. Complete los parámetros de las páginas siguientes.
  6. En la página Resumen, compruebe los detalles del catálogo de máquinas. Introduzca un nombre y una descripción para el catálogo de máquinas. Haga clic en Finalizar.
  7. Vaya al nodo Catálogos de máquinas para ver el catálogo de máquinas creado.

Crear un catálogo de máquinas desde el nodo Catálogos de máquinas

Para crear un catálogo de máquinas de MCS desde el nodo Catálogos de máquinas, haga lo siguiente:

  1. Haga clic en Catálogos de máquinas en el panel de navegación izquierdo.
  2. Haga clic en Crear catálogo de máquinas. Aparecerá la página Configuración de catálogo de máquinas. Haga clic en Siguiente en las páginas Introducción, Tipo de máquina y Administración de máquinas.
  3. En la página Imagen:
    1. Seleccione Imagen preparada.
    2. En la imagen preparada, seleccione una versión de imagen de una definición de imagen.
    3. Haga clic en el nombre de la versión de la imagen. Para ver más detalles sobre la versión de la imagen seleccionada, haga clic en el número de versión, que aparece subrayado.
    4. Si la versión de imagen seleccionada está configurada con un perfil de máquina, seleccione un perfil de máquina. Si la versión de imagen seleccionada no está configurada con un perfil de máquina, no puede elegir usar un perfil de máquina.
  4. Configure los parámetros en las páginas siguientes.
  5. En la página Parámetros del disco, si la imagen preparada seleccionada usa un conjunto de cifrado de disco, no puede quitar el conjunto de cifrado, pero puede cambiar la clave por otra clave de cifrado.
  6. (Para Azure) En la página Grupo de recursos, puede optar por crear un nuevo grupo de recursos o usar un grupo de recursos existente para colocar los recursos de este catálogo.
  7. Complete los parámetros de las páginas siguientes.
  8. En la página Resumen, compruebe los detalles del catálogo de máquinas. Introduzca un nombre y una descripción para el catálogo de máquinas. Haga clic en Finalizar.

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:

  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 quiere actualizar. Haga clic con el botón secundario y seleccione Cambiar imagen preparada.
  2. En la página Imagen, seleccione una imagen preparada.
  3. En la página Estrategia de implantación, seleccione cuándo quiere actualizar este catálogo con la imagen preparada seleccionada.
  4. En la página Resumen, compruebe los detalles. Haga clic en Finalizar.

Puede ver el historial de los 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 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:

  1. 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:

  1. 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:

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

Nota:

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:

  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.

Administración del ciclo de vida de las imágenes mediante PowerShell

Si quiere usar los comandos de PowerShell para crear un esquema de aprovisionamiento, debe crear una especificación de versión de imagen preparada basada en la especificación de versión de imagen maestra, según sea necesario para su entorno.

Especificación de versión de imagen maestra: Una especificación de versión de imagen maestra es una imagen específica que se agrega o crea bajo una versión de imagen. Puede agregar una imagen existente en el hipervisor como especificación de versión de imagen maestra o crear una especificación de versión de imagen preparada basada en la especificación de versión de imagen maestra, según sea necesario para su entorno. La especificación de versión de imagen preparada se puede usar para varios esquemas de aprovisionamiento.

El ciclo de vida de una imagen cuando se usan los comandos de PowerShell es:

  1. Crear una imagen:

    1. Crear una definición de imagen.
    2. Crear una versión de imagen.
    3. Agregar una especificación de versión de imagen maestra.
    4. Crear una especificación de versión de imagen preparada.

  2. Crear un catálogo de máquinas de MCS con una especificación de versión de imagen preparada:

    1. Crear un catálogo de brokers.
    2. Crear un grupo de identidades.
    3. Crear un esquema de aprovisionamiento con el parámetro UID de especificación de versión de imagen preparada mediante el comando New-ProvScheme.
    4. Vincular el catálogo de brokers al esquema de aprovisionamiento.
  3. Crear máquinas virtuales en el catálogo de máquinas de MCS.
  4. Cambiar la especificación de versión de imagen preparada de un esquema de aprovisionamiento mediante el comando Set-ProvScheme.
  5. Administrar las definiciones y versiones de las imágenes: Modificar las versiones y definiciones de las imágenes.
  6. Eliminar un catálogo de máquinas de MCS. El orden de eliminación es: especificación de versión de imagen preparada > especificación de versión de imagen maestra > versión de imagen > definición de imagen. Antes de eliminar la especificación de versión de la imagen, asegúrese de que la especificación de versión de la imagen preparada no esté asociada a ningún catálogo de máquinas de MCS.

Usar PowerShell

Puede hacer lo siguiente con los comandos de PowerShell:

Crear una imagen preparada

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 mediante Test-ProvImageDefinitionNameAvailable command. Por ejemplo,

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

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

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

  3. Cree una versión de imagen con el comando New-ProvImageVersion. Por ejemplo,

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

  4. Agregue una especificación de versión de imagen maestra a la versión de la imagen mediante el comando Add-ProvImageVersionSpec. Por ejemplo,

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
<!--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.

  5. Cree una especificación de versión de imagen preparada a partir de la especificación de versión de imagen maestra mediante el comando New-ProvImageVersionSpec. Por ejemplo,

    New-ProvImageVersionSpec
-SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
-NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
-ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
<!--NeedCopy-->

    Nota:

    Una unidad de alojamiento y un tipo de preparación solo pueden tener una instancia preparada.

Ejemplo del conjunto completo de comandos de PowerShell para crear la definición de imagen, versión de imagen y especificación de versión de imagen preparada en Azure:

$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell para crear la definición de imagen, versión de imagen y especificación de versión de imagen preparada en VMware:

$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
<!--NeedCopy-->

Nota:

  • Todas las especificaciones de versión de imagen de 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 o ninguna de las especificaciones de versión de imagen debe tener un perfil de máquina.
  • No puede especificar un grupo de recursos al crear una especificación de versión de imagen.

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

Para crear un catálogo de máquinas de MCS a partir de la especificación de versión de imagen preparada, use el comando New-ProvScheme. Por ejemplo,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

O bien,

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell para crear un catálogo en Azure:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Ejemplo del conjunto completo de comandos de PowerShell para crear un catálogo en VMware:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

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]
<!--NeedCopy-->

O bien,

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.
  • No se puede eliminar una especificación de versión de imagen preparada si la usa algún esquema de aprovisionamiento.

Estos son los pasos detallados:

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

    Nota:

    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.

  2. 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 -RunAsynchronously
<!--NeedCopy-->

  3. Quite una versión de imagen. Por ejemplo,

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

  4. Quite una definición de imagen. Por ejemplo,

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

Ejemplo del conjunto completo de comandos de PowerShell:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
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.

  • Para cambiar el nombre de una definición de imagen, use el comando Rename-ProvImageDefinition. Por ejemplo:

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

    O bien,

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

  • Para modificar una definición de imagen, use el comando Set-ProvImageDefinition. Por ejemplo:

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

    O bien,

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

  • Para modificar una versión de imagen, use 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, versión de imagen, especificación de versión de imagen preparada y detalles del esquema de aprovisionamiento

  • Para obtener los detalles de una definición de imagen, use el comando Get-ProvImageDefinition. Por ejemplo:

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

  • Para obtener los detalles de una versión de imagen, use el comando Get-ProvImageVersion. Por ejemplo:

    • Para enumerar las versiones de imagen de 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-->

  • Para obtener la especificación de versión de imagen preparada, use 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>
 <!--NeedCopy-->

    • 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"'
 <!--NeedCopy-->

    • 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>
 <!--NeedCopy-->

  • Para obtener los detalles del esquema de aprovisionamiento, use 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-->

  • Para obtener un historial de especificaciones de versión de imagen preparada de un esquema de aprovisionamiento, use 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-->
Administración de imágenes (Technical Preview)
September 13, 2024
Contribución de: 
C
September 13, 2024
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.