Gestión de imágenes (Vista previa)

Introducción

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

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

Con la funcionalidad de gestió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 utilizarlas en varios catálogos de máquinas 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 gestión de imágenes son:

• Generar imágenes preparadas con antelación sin crear un catálogo.
• Reutilizar imágenes preparadas en varios escenarios, como la creación y actualización de un catálogo.
• Reducir significativamente el tiempo de creación o actualización del catálogo.

Nota:

• Esta función se aplica actualmente a 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á obtener las ventajas de la función.

Casos de uso

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

• Gestión de versiones: Las versiones de imagen le permiten:

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

• Agrupación lógica: Puede crear varias definiciones de imagen para:

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

¿Qué es una imagen preparada?

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

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

Puede crear las imágenes preparadas con antelación. Puede usar una única imagen preparada para crear o actualizar varios catálogos de máquinas aprovisionados por MCS.

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

Definición de imagen: Las definiciones de imagen son una agrupación lógica de versiones de una imagen. La definición de 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 basándose en la definición de imagen.

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

Alternativamente, si desea utilizar 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 imagen maestra según sea necesario para su entorno.

Participar en la Tech Preview

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

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

Requisito

• Para las imágenes maestras de Windows, solo se admiten las imágenes VDA de la versión 2311 o posterior. El componente MCS/IO debe seleccionarse e instalarse explícitamente. La habilitación o deshabilitación de la configuración de E/S de MCS debe determinarse durante la creación o actualización del catálogo de máquinas, ya que no está habilitada de forma predeterminada.

Limitaciones

Actualmente, la función no admite lo siguiente:

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

Administración del ciclo de vida de la imagen con Web Studio

El ciclo de vida de la imagen cuando se utiliza Web Studio es:

1. Crear una imagen preparada: Cree una definición de imagen y su versión de imagen inicial.
2. Crear versiones de imagen a partir de la versión de imagen inicial.
3. Utilice 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: Edite 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.

Alternativamente, también puede administrar imágenes mediante PowerShell. Consulte Administración del ciclo de vida de la imagen con PowerShell.

Crear o actualizar un catálogo con una imagen preparada

Cree imágenes preparadas y utilícelas para crear o actualizar un catálogo de máquinas MCS mediante:

• Web Studio
• Comandos de PowerShell

Usar Web Studio

Consulte los siguientes temas:

• Comprender el nodo Imágenes
• Crear una definición de imagen y una versión de imagen inicial
• Crear versiones de imagen
• Crear un catálogo de máquinas desde el nodo Imágenes
• Crear un catálogo de máquinas desde el nodo Catálogos de máquinas
• Actualizar un catálogo de máquinas con una imagen preparada diferente
• Administrar las definiciones y versiones de imagen

Comprender el nodo Imágenes

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

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. Cree la definición de imagen y las versiones iniciales de la imagen.
2. Utilice la versión de la imagen como imagen preparada para crear un catálogo.

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. Inicie sesión en Web Studio y seleccione el nodo Images. Haga clic en Next en la página Introduction.
2. En la página Image Definition, especifique el OS type y el Session type para la definición de imagen.

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

   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.

4. (Solo para Azure) En la página Tipos de almacenamiento y licencias, seleccione el tipo de almacenamiento y licencia que se utilizará 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 selecciona previamente según la configuración del perfil.

5. En la página Especificaciones de la máquina:

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

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

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

   Nota:

   No se admiten varias NIC en Azure.

7. (Solo para Azure) En la página Configuración de disco, seleccione la clave de cifrado administrada por el cliente (CMEK). Si el perfil de máquina no tiene una CMEK, pero la imagen maestra sí, se selecciona previamente 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 inicial de la imagen creada.
9. En la página Summary, compruebe los detalles de la definición de imagen y la versión de imagen inicial creada. Introduzca un nombre y una descripción para la definición de imagen. Haga clic en Finish.

Crear versiones de imagen

Las versiones de imagen permiten la administració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 de imagen inicial, haga lo siguiente:

Nota:

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

1. Vaya al nodo Images, seleccione una versión de imagen y seleccione Create Image Version.
2. Si quiere que la configuración de la versión de imagen sea diferente de la versión de imagen inicial configurada, configure los ajustes en las páginas Image, Storage and License Types, Machine Specification, NICs y Disk Settings del cuadro de diálogo Create Image Version.
3. Agregue una descripción para la versión de imagen. Haga clic en Finish.

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

Utilice la opción Create catalog en el nodo Images para crear un catálogo con la versión de imagen.

Alternativamente, puede seleccionar la versión al crear un catálogo en el nodo Machine Catalogs, vinculando 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 MCS desde el nodo Images, haga lo siguiente:

1. Seleccione una versión de imagen y haga clic en Create catalog. Haga clic en Next en la página Introduction.
2. En la página Experiencia de escritorio, seleccione la experiencia de escritorio requerida.
3. Desde la página Imagen hasta la página Configuración de disco, la configuración está preseleccionada según 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 uno existente para colocar los recursos de este catálogo.
5. Complete la configuración en las siguientes páginas.
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 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. Aparece la página Configuración del catálogo de máquinas. Haga clic en Siguiente para pasar por 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 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 imagen seleccionada, haga clic en el número de versión, que está 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 ajustes en las siguientes páginas.
5. En la página Configuración de disco, si la imagen preparada seleccionada utiliza 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 utilizar un grupo de recursos existente para colocar los recursos de este catálogo.
7. Complete la configuración en las siguientes páginas.
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 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 un catálogo de máquinas que desee actualizar. Haga clic con el botón derecho y seleccione Cambiar imagen preparada.
2. En la página Imagen, seleccione una imagen preparada.
3. En la página Estrategia de implementación, seleccione cuándo desea 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 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 pestaña Propiedades de plantilla, en el campo Imagen preparada, haga clic en Ver historial de imágenes.

Administrar las definiciones y versiones de las imágenes

Puede editar y eliminar las definiciones y versiones de imagen para gestionar el uso de las diversas versiones y definiciones de imagen 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, a continuación, 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, a continuación, 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, a continuación, 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.

Administración del ciclo de vida de la imagen mediante PowerShell

Si desea utilizar 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: Es una imagen específica añadida o creada bajo una versión de imagen. Puede añadir una imagen existente en el hipervisor como una especificación de versión de imagen maestra o crear una especificación de versión de imagen preparada basada en dicha especificación según sea necesario para su entorno. La especificación de versión de imagen preparada se puede utilizar para varios esquemas de aprovisionamiento.

El ciclo de vida de una imagen al usar 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 MCS utilizando una especificación de versión de imagen preparada:

   1. Crear un catálogo de intermediario.
   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 intermediación con el 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 imágenes: Editar las versiones y definiciones de 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 imagen, asegúrese de que la especificación de versión de imagen preparada no esté asociada a ningún catálogo de máquinas de MCS.

Usar PowerShell

Puede hacer lo siguiente mediante comandos de PowerShell:

• Crear una imagen preparada

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

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

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

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

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

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 mediante el comando New-ProvImageDefinition. Por ejemplo,

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

3. Cree una versión de imagen mediante 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 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 una definición de imagen, una versión de imagen y una 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 una definición de imagen, una versión de imagen y una 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

Cree un catálogo de máquinas MCS a partir de la especificación de versión de imagen preparada mediante 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, la versión de imagen y la 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 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 esquema de aprovisionamiento.

Los pasos detallados son los siguientes:

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

   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.

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

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

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

4. Elimine 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 de imagen y la versión de 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 mediante 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 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 la versión de imagen preparada y el esquema de aprovisionamiento

• Obtenga 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-->
  

• Obtenga 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-->
    

• Obtenga la especificación de la 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 asociada a una imagen maestra,

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

  • Para obtener especificaciones de versión de imagen preparadas exitosas 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 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 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-->