Administrar un catálogo de Microsoft Azure

Nota:

Desde julio de 2023, Microsoft ha cambiado el nombre de Azure Active Directory (Azure AD) a Microsoft Entra ID. En este documento, cualquier referencia a Azure Active Directory, Azure AD o AAD ahora se refiere a Microsoft Entra ID.

(/es-es/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage.html) describe los asistentes que administran un catálogo de máquinas. La siguiente información cubre detalles específicos de los entornos de nube de Microsoft Azure Resource Manager.

Nota:

Antes de administrar un catálogo de Microsoft Azure, debe terminar de crear un catálogo de Microsoft Azure. Consulte (/es-es/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-create/create-machine-catalog-citrix-azure.html).

Cambiar el tipo de almacenamiento a un nivel inferior cuando una VM está apagada

Puede ahorrar costes de almacenamiento cambiando el tipo de almacenamiento de un disco administrado a un nivel inferior cuando apaga una VM. Para ello, utilice la propiedad personalizada StorageTypeAtShutdown.

El tipo de almacenamiento del disco cambia a un nivel inferior (según lo especificado en la propiedad personalizada StorageTypeAtShutdown) cuando apaga la VM. Después de encender la VM, el tipo de almacenamiento vuelve al original (según lo especificado en la propiedad personalizada StorageType o la propiedad personalizada WBCDiskStorageType).

Importante:

El disco no existe hasta que la VM se enciende al menos una vez. Por lo tanto, no puede cambiar el tipo de almacenamiento la primera vez que enciende la VM.

Requisitos

• Aplicable a un disco administrado. Esto implica que debe establecer la propiedad personalizada UseManagedDisks en true.
• Aplicable a un catálogo persistente y no persistente con un disco de SO persistente. Esto implica que debe establecer la propiedad personalizada persistOsDisk en true.
• Aplicable a un catálogo no persistente con un disco WBC persistente. Esto implica que debe establecer la propiedad personalizada persistWBC en true.

Restricción

• Según Microsoft, solo puede cambiar el tipo de disco dos veces al día. Consulte el documento de Microsoft. Según Citrix, la actualización StorageType se produce cada vez que hay una acción de Inicio o Desasignación para la VM. Por lo tanto, limite el número de acciones de energía por VM a dos veces al día. Por ejemplo, una acción de energía por la mañana para iniciar la VM y otra por la tarde para desasignar la VM.

Cambiar el tipo de almacenamiento a un nivel inferior

Antes de continuar con los pasos, consulte los (#requirements) y la (#restriction).

1. Agregue la propiedad personalizada StorageTypeAtShutdown, establezca el valor en Standard_LRS (HDD) y cree un catálogo usando New-ProvScheme. Para obtener información sobre cómo crear un catálogo usando PowerShell, consulte https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

   Nota:

   Si StorageTypeAtShutdown tiene un valor distinto de vacío o Standard_LRS (HDD), la operación falla.

   Ejemplo de configuración de propiedades personalizadas al crear un catálogo persistente:

   $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
   <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
   <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
   <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
   <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
   <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
   <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
   </CustomProperties>'
   <!--NeedCopy-->
   

   Ejemplo de configuración de propiedades personalizadas al crear un catálogo no persistente:

   $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
   <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
   <Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
   <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
   <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
   <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
   <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
   <Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
   <Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
   <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
   </CustomProperties>'
   <!--NeedCopy-->
   

   Nota:

   Cuando utiliza un perfil de máquina, la propiedad personalizada tiene prioridad sobre la propiedad definida en MachineProfile.

2. Apague la VM y compruebe el tipo de almacenamiento de la VM en el portal de Azure. El tipo de almacenamiento del disco cambia a un nivel inferior, como se especifica en la propiedad personalizada StorageTypeAtShutdown.
3. Encienda la VM. El tipo de almacenamiento del disco vuelve al tipo de almacenamiento mencionado en:
   • Propiedad personalizada StorageType para el disco del SO
   • Propiedad personalizada WBCDiskStorageType para el disco WBC solo si lo especifica en CustomProperties. De lo contrario, vuelve al tipo de almacenamiento mencionado en StorageType.

Aplicar StorageTypeAtShutdown a un catálogo existente

Antes de continuar con los pasos, consulte los Requisitos y la Restricción.

Utilice Set-ProvScheme para agregar una VM a un catálogo existente. La función se aplica a las nuevas VM agregadas después de ejecutar Set-ProvScheme. Las máquinas existentes no se ven afectadas.

Ejemplo de cómo establecer propiedades personalizadas al agregar una VM a un catálogo existente:

$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

Set-ProvScheme -ProvisioningSchemeName $ProvScheme.ProvisioningSchemeName -CustomProperties $customProperties
<!--NeedCopy-->

Cambiar el tipo de almacenamiento de las VM existentes a un nivel inferior al apagarse

Antes de continuar con los pasos, consulte los Requisitos y la Restricción.

Puede ahorrar costes de almacenamiento cambiando el tipo de almacenamiento de las VM existentes a un nivel inferior cuando las VM se apagan. Para ello, utilice la propiedad personalizada StorageTypeAtShutdown.

Para cambiar el tipo de almacenamiento de las máquinas existentes en un catálogo a un nivel inferior cuando las VM se apagan:

1. Abra una ventana de PowerShell.
2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
3. Ejecute Get-Provscheme -ProvisioningSchemeName $CatalogName.

4. Cambie la cadena de propiedades personalizadas.

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
   </CustomProperties>'
   <!--NeedCopy-->
   

5. Actualice el esquema de aprovisionamiento del catálogo existente. La actualización se aplica a las nuevas VM agregadas después de ejecutar Set-ProvScheme.

   Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties
   <!--NeedCopy-->
   

6. Actualice las VM existentes para habilitar StorageTypeAtShutdown.

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName $CatalogName -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

7. La próxima vez que encienda las máquinas, la propiedad StorageTypeAtShutdown de las máquinas se actualizará. El tipo de almacenamiento cambia en el siguiente apagado.

8. Ejecute el siguiente comando para ver el valor StorageTypeAtShutdown de cada VM en un catálogo:

   Get-ProvVM -ProvisioningSchemeName <catalog-name> | foreach { $vmName = $_.VMName; $storageTypeAtShutdown = ($_.CustomVmData | ConvertFrom-Json).StorageTypeAtShutdown.DiskStorageAccountType; return New-Object psobject -Property @{ "VMName" = $vmName; "StorageTypeAtShutdown" = $storageTypeAtShutdown } }
   <!--NeedCopy-->
   

Actualizar las máquinas aprovisionadas al estado actual del esquema de aprovisionamiento

El comando Set-ProvScheme cambia el esquema de aprovisionamiento. Sin embargo, no afecta a las máquinas existentes. Con el comando de PowerShell Set-ProvVMUpdateTimeWindow, puede aplicar el esquema de aprovisionamiento actual a una máquina o conjunto de máquinas persistentes o no persistentes existentes. También puede programar un intervalo de tiempo para las actualizaciones de configuración de las máquinas aprovisionadas por MCS existentes. Cualquier encendido o reinicio durante el intervalo de tiempo programado aplica una actualización programada del esquema de aprovisionamiento a una máquina. Actualmente, en Azure, puede actualizar ServiceOffering, MachineProfile y las siguientes propiedades personalizadas:

• StorageType
• WBCDiskStorageType
• IdentityDiskStorageType
• LicenseType
• DedicatedHostGroupId
• PersistWBC
• PersistOsDisk
• PersistVm

Nota:

• Solo puede actualizar las propiedades personalizadas StorageType, WBCDiskStorageType y IdentityDiskStorageType de un catálogo que utilice discos administrados en entornos de Azure.
• Si ejecuta Set-ProvVMUpdateTimeWindow dos veces, el comando más reciente surte efecto.

Puede actualizar:

• Una única VM
• Una lista de VM específicas o todas las VM existentes asociadas a un ID de esquema de aprovisionamiento
• Una lista de VM específicas o todas las VM existentes asociadas a un nombre de esquema de aprovisionamiento (nombre del catálogo de máquinas)

Después de realizar los siguientes cambios en el esquema de aprovisionamiento, la instancia de VM se vuelve a crear para los catálogos persistentes en Azure:

• Cambiar el MachineProfile
• Quitar LicenseType
• Quitar DedicatedHostGroupId

Nota:

El disco del sistema operativo de las máquinas existentes, junto con todos sus datos, permanece intacto y se adjunta una nueva VM al disco.

Antes de actualizar las VM existentes:

1. Compruebe la configuración de las máquinas existentes. Por ejemplo,

   Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
   <!--NeedCopy-->
   

2. Actualice el esquema de aprovisionamiento. Por ejemplo,

   • Con la VM como entrada de perfil de máquina:

      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<virtual-machine>.vm"
      <!--NeedCopy-->
     

   • Con la especificación de plantilla como entrada de perfil de máquina:

      Set-ProvScheme -ProvisioningSchemeName "my-catalog"
      -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
      -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
      <!--NeedCopy-->
     

   • Solo con la oferta de servicio:

      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
      <!--NeedCopy-->
     

3. Compruebe si la propiedad actual de la VM coincide con el esquema de aprovisionamiento actual y si hay alguna acción de actualización pendiente en la VM. Por ejemplo,

   Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
   <!--NeedCopy-->
   

   También puede encontrar máquinas con una versión específica. Por ejemplo,

   Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
   <!--NeedCopy-->
   

Para solicitar que las actualizaciones de las máquinas existentes se apliquen en el siguiente reinicio:

1. Ejecute los siguientes comandos para actualizar las máquinas existentes y que las actualizaciones se apliquen en el siguiente reinicio.

   • Para actualizar todas las máquinas existentes. Por ejemplo,

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
     

   • Para actualizar una lista de máquinas específicas. Por ejemplo,

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
     

   • Para actualizar máquinas basándose en la salida de Get-ProvVM. Por ejemplo,

      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
     

   Nota:

   • StartsNow indica que la hora de inicio programada es la hora actual.
   • DurationInMinutes con un número negativo (por ejemplo, –1) indica que no hay límite superior en la ventana de tiempo de la programación.

2. Encuentre máquinas con una actualización programada. Por ejemplo,

   Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
   <!--NeedCopy-->
   

3. Reinicie las máquinas. En el siguiente encendido, los cambios de propiedad se aplican a las máquinas existentes. Puede comprobar el estado actualizado con el siguiente comando. Por ejemplo,

   Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
   <!--NeedCopy-->
   

Para programar una VM para que se actualice a la configuración de aprovisionamiento más reciente la próxima vez que se inicie en la ventana de tiempo programada:

1. Ejecute los siguientes comandos:

   • Para programar una actualización con la hora de inicio como la hora actual

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
      <!--NeedCopy-->
     

   • Para programar una actualización en un fin de semana

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
      <!--NeedCopy-->
     

   Nota:

   • VMName es opcional. Si no se especifica, la actualización se programa para todo el catálogo.
   • En lugar de StartTimeInUTC, use StartsNow para indicar que la hora de inicio programada es la hora actual.
   • DurationInMinutes es opcional. El valor predeterminado es 120 minutos. Un número negativo (por ejemplo, –1) indica que no hay límite superior en la ventana de tiempo de la programación.

2. Compruebe el estado de la actualización.

   Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
   <!--NeedCopy-->
   

3. Encienda la VM. Si enciende la máquina después del intervalo de tiempo programado, no se aplica la actualización de la configuración. Si enciende la máquina dentro del intervalo de tiempo programado,

   • Si la máquina está apagada y

     • no enciende la máquina, no se aplica la actualización de la configuración
     • enciende la máquina, se aplica la actualización de la configuración

   • Si la máquina está encendida y

     • no reinicia la máquina, no se aplica la actualización de la configuración
     • reinicia la máquina, se aplica la actualización de la configuración

Para cancelar la actualización de la configuración:

También puede cancelar una actualización de la configuración de una sola VM, de varias VM o de un catálogo completo. Para cancelar una actualización de la configuración:

1. Ejecute Clear-ProvVMUpdateTimeWindow. Por ejemplo:

   • Para cancelar la actualización de la configuración programada para una sola VM:

       Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
       <!--NeedCopy-->
     

   • Para cancelar la actualización de la configuración programada para varias VM:

      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
      <!--NeedCopy-->
     

     Nota:

     Las VM deben ser del mismo catálogo.

Actualizar propiedades de VM individuales

Puede actualizar las propiedades de VM individuales en un catálogo de máquinas MCS persistente mediante el comando de PowerShell Set-ProvVM. Sin embargo, las actualizaciones no se aplican de inmediato. Debe establecer el período de tiempo mediante el comando de PowerShell Set-ProvVMUpdateTimeWindow para que se apliquen las actualizaciones.

Esta implementación le ayuda a administrar VM individuales de forma eficiente sin actualizar todo el catálogo de máquinas. Actualmente, esta función solo se aplica al entorno de Azure.

Actualmente, las propiedades que puede actualizar son:

• CustomProperties
• ServiceOffering
• MachineProfile

Con esta función, puede:

• Actualizar las propiedades de una VM
• Conservar las propiedades actualizadas en una VM después de actualizar el catálogo de máquinas
• Revertir las actualizaciones de configuración aplicadas a una VM

Antes de actualizar las propiedades de una VM:

1. Abra una ventana de PowerShell.
2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

3. Compruebe la configuración del catálogo de máquinas existente. Por ejemplo:

   Get-ProvScheme -ProvisioningSchemeName AzureCatalog
   <!--NeedCopy-->
   

4. Compruebe la configuración de la VM en la que desea aplicar las actualizaciones. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

Actualizar propiedades de una VM

Siga estos pasos para actualizar las propiedades de una VM:

1. Apague la VM en la que desea aplicar las actualizaciones.

2. Actualice las propiedades de la VM. Por ejemplo, si desea actualizar la propiedad personalizada de tipo de almacenamiento (StorageType) de la VM, ejecute lo siguiente:

   Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
   <!--NeedCopy-->
   

   Puede actualizar las propiedades de dos VM en un catálogo de máquinas simultáneamente. Por ejemplo:

   Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
   <!--NeedCopy-->
   

   Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
   <!--NeedCopy-->
   

   Nota:

   Las actualizaciones no se aplican inmediatamente.

3. Obtenga la lista de propiedades que se especifican para actualizar y la versión de configuración. Por ejemplo:

   Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   Compruebe el valor de la propiedad de Version y las propiedades que se van a actualizar (en este caso, StorageType).

4. Compruebe la versión de la configuración. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   Compruebe el valor de la propiedad de ProvVMConfigurationVersion. La actualización aún no se ha aplicado. La VM sigue con la configuración antigua.

5. Solicite una actualización programada. Por ejemplo:

    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
    <!--NeedCopy-->
   

   Para obtener más información sobre las actualizaciones programadas, consulte Actualizar máquinas aprovisionadas al estado actual del esquema de aprovisionamiento.

   Nota:

   También se aplica cualquier actualización pendiente del esquema de aprovisionamiento.

6. Reinicie la VM. Por ejemplo:

   New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
   <!--NeedCopy-->
   

7. Compruebe la versión de la configuración. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   Compruebe el valor de la propiedad de ProvVMConfigurationVersion. La actualización ya se ha aplicado. La VM ahora tiene la nueva configuración.

8. Para aplicar más actualizaciones de configuración en la VM, apague la VM y repita los pasos.

Conservar las propiedades actualizadas en una VM después de actualizar el catálogo de máquinas

Haga lo siguiente para conservar las propiedades actualizadas en una VM:

1. Apague la VM en la que quiera aplicar las actualizaciones.

2. Actualice el catálogo de máquinas. Por ejemplo, si quiere cambiar el tamaño de la VM (ServiceOffering) y el tipo de almacenamiento (StorageType), ejecute lo siguiente:

   Set-ProvScheme -ProvisioningSchemeName AzureCatalog -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
   <!--NeedCopy-->
   

3. Obtenga los detalles de configuración del catálogo de máquinas. Por ejemplo:

   Get-ProvScheme -ProvisioningSchemeName AzureCatalog
   <!--NeedCopy-->
   

   El ProvisioningSchemeVersion ahora se incrementa en uno. El tamaño de la VM y el tipo de almacenamiento también se actualizan.

4. Actualice las propiedades de la VM. Por ejemplo, proporcione un perfil de máquina a la VM.

   Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
   <!--NeedCopy-->
   

   Nota:

   La entrada del perfil de máquina tiene una etiqueta y un tamaño de VM diferente (ServiceOffering) especificados.

5. Obtenga la lista de propiedades que tendrá la VM después de fusionar las actualizaciones de configuración de la VM con las actualizaciones del catálogo de máquinas. Por ejemplo:

   Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   Nota:

   Cualquier actualización en la VM anulará las actualizaciones realizadas en el catálogo de máquinas.

6. Solicite una actualización programada para la VM. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

7. Reinicie la VM. Por ejemplo:

   New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
   <!--NeedCopy-->
   

   La VM mantiene su tamaño de VM actualizado tal como se deriva del perfil de máquina. Los valores de etiqueta especificados en el perfil de máquina también se aplican a la VM. Sin embargo, el tipo de almacenamiento se deriva del esquema de aprovisionamiento más reciente.

8. Obtenga la versión de configuración de la VM. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   El ProvisioningSchemeVersion y ProvVMConfigurationVersion ahora muestran la última versión.

Revertir las actualizaciones de configuración aplicadas a una VM

1. Después de aplicar las actualizaciones a una VM, apague la VM.

2. Ejecute el siguiente comando para eliminar las actualizaciones aplicadas en la VM. Por ejemplo:

   Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

3. Solicite una actualización programada para la VM. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

4. Reinicie la VM. Por ejemplo:

   New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
   <!--NeedCopy-->
   

5. Compruebe la versión de configuración de la VM. Por ejemplo:

   Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
   <!--NeedCopy-->
   

   El valor ProvVMConfigurationVersion es ahora la versión de configuración del catálogo de máquinas.

Cambiar el cifrado de disco

Puede cambiar el cifrado de disco en entornos de virtualización de Azure y hacer lo siguiente:

• Cree un catálogo de máquinas MCS con un conjunto de cifrado de disco (DES) diferente del DES de la imagen maestra mediante el comando New-ProvScheme. Por ejemplo:

   $customProperties = @"
   <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="DiskEncryptionSetId" Name="Zones" Value="/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/testrsg/providers/Microsoft.Compute/diskEncryptionSets/test-diskEncryptionSet"/>
   </CustomProperties>
   "@
   New-ProvScheme -CleanOnBoot `
   -ProvisioningSchemeName $provisioningSchemeName `
   -HostingUnitName $hostingUnitName `
   -IdentityPoolName $identityPoolName `
   -InitialBatchSizeHint $numberOfVms `
   -masterImagePath $masterImagePath `
   -NetworkMapping $networkMapping `
   -CustomProperties $customProperties
   <!--NeedCopy-->
  

• Cambie el tipo de cifrado de disco de una clave DES a otra clave DES de un catálogo de máquinas MCS existente y de las VM existentes mediante los comandos Set-ProvScheme y Set-ProvVMUpdateTimeWindow. Después de reiniciar las VM, podrá ver la clave DES actualizada. Por ejemplo:

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
   </CustomProperties>'
   Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
  

• Actualice un catálogo de máquinas MCS y una VM que no estuvieran previamente habilitados para CMEK para que tengan cifrado de clave de cifrado administrada por el cliente (CMEK) (DES), cifrado de disco en el host o cifrado doble mediante los comandos Set-ProvScheme y Set-ProvVMUpdateTimeWindow. Para obtener información sobre los diferentes tipos de cifrado, consulte Cifrado del lado del servidor de Azure, Cifrado de disco de Azure en el host y Cifrado doble en disco administrado.

• Actualice un catálogo de máquinas MCS y una VM existentes que estaban cifrados previamente para que no estén cifrados mediante los comandos Set-ProvScheme y Set-ProvVMUpdateTimeWindow. Por ejemplo:

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
   </CustomProperties>'
   Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
  

• Habilite el cifrado de disco con un punto de conexión privado (un catálogo de máquinas MCS que utilizó una conexión de host habilitada con ProxyHypervisorTrafficThroughConnector). Para obtener información sobre cómo habilitar el cifrado de disco con puntos de conexión privados, consulte Habilitar el cifrado de disco con un punto de conexión privado.

Habilitar el cifrado de disco con un punto de conexión privado

Según la limitación de Azure, actualmente no se puede tener cifrado del lado del servidor con claves administradas por el cliente para puntos de conexión privados. Sin embargo, puede actualizar un catálogo de máquinas MCS y las VM existentes con puntos de conexión privados para que se cifren con la clave DES.

Actualizar un catálogo de máquinas existente con puntos de conexión privados

Los pasos detallados para actualizar un catálogo de máquinas existente con puntos de conexión privados son los siguientes:

1. Cree un catálogo sin cifrado de disco mediante ProxyHypervisorTrafficThroughConnector.

2. Ejecute Set-ProvScheme para actualizar el catálogo con DiskEncryptionSetId.

   Nota:

   DiskEcryptionSetId se puede configurar mediante CustomProperties o MachineProfile. Cuando se define tanto en CustomProperties como en MachineProfile, se aplican las propiedades definidas en CustomProperties.

   Ejemplo al usar CustomProperties:

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1"/>
   </CustomProperties>'
   Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
   <!--NeedCopy-->
   

   Ejemplo al usar MachineProfile: Utilice una VM con el cifrado de disco habilitado o una especificación de plantilla con la configuración de cifrado de disco:

   Set-ProvScheme -ProvisioningSchemeName azure-catalog -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
   <!--NeedCopy-->
   

   También puede actualizar un perfil de máquina mediante Web Studio.

3. Ejecute Set-ProvVMUpdateTimeWindow para actualizar las VM de catálogo existentes. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

4. Después de reiniciar las VM, puede ver el cifrado de disco actualizado en los discos de la VM en el portal de Azure.

5. Ejecute Set-ProvScheme para anular el cifrado de disco antes de agregar nuevas VM al catálogo.

   Nota:

   Este paso es necesario porque está actualizando un catálogo de puntos de conexión privados. Si no realiza este paso, obtendrá errores al intentar agregar nuevas VM al catálogo.

   Por ejemplo:

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
   </CustomProperties>'
   Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
   <!--NeedCopy-->
   

6. Agregue nuevas VM al catálogo.

Actualizar VM de catálogo individuales

Los pasos detallados para actualizar las VM de catálogo individuales son los siguientes:

1. Cree un catálogo sin cifrado de disco a través de ProxyHypervisorTrafficThroughConnector.

2. Ejecute Set-ProvVM para actualizar la VM del catálogo con DiskEncryptionSetId.

   Nota:

   El DiskEcryptionSetId se puede configurar a través de CustomProperties o MachineProfile.

   Ejemplo al usar CustomProperties:

   $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
   </CustomProperties>'
   Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -CustomProperties $customProperties
   <!--NeedCopy-->
   

   Ejemplo al usar MachineProfile:

   Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
   <!--NeedCopy-->
   

3. Ejecute Set-ProvVMUpdateTimeWindow para actualizar las VM de catálogo existentes. Por ejemplo:

   Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1
   <!--NeedCopy-->
   

4. Después de reiniciar las VM, puede ver el cifrado de disco actualizado en los discos de las VM en el portal de Azure.
5. Agregue nuevas VM al catálogo.

Recuperar información de VM de Azure, instantáneas, disco del sistema operativo y definición de imagen de galería

Puede mostrar información de una VM de Azure, incluido el disco y el tipo de sistema operativo, la instantánea y la definición de la imagen de la galería. Esta información se muestra para los recursos de la imagen maestra cuando se asigna un catálogo de máquinas. Utilice esta funcionalidad para ver y seleccionar una imagen de Linux o Windows. Se agregó una propiedad de PowerShell, TemplateIsWindowsTemplate, al parámetro AdditionDatafield. Este campo contiene información específica de Azure: tipo de VM, disco del sistema operativo, información de la imagen de la galería e información del tipo de sistema operativo. Establecer TemplateIsWindowsTemplate en True indica que el tipo de sistema operativo es Windows; establecer TemplateIsWindowsTemplate en False indica que el tipo de sistema operativo es Linux.

Sugerencia:

La información mostrada por la propiedad de PowerShell TemplateIsWindowsTemplate se deriva de la API de Azure. A veces, este campo puede estar vacío. Por ejemplo, una instantánea de un disco de datos no contiene el campo TemplateIsWindowsTemplate porque el tipo de sistema operativo no se puede recuperar de una instantánea.

Por ejemplo, establezca el parámetro AdditionData de la VM de Azure en True para el tipo de sistema operativo Windows mediante PowerShell:

PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData
Key Value
ServiceOfferingDescription Standard_B2ms
HardDiskSizeGB 127
ResourceGroupName FENGHUAJ-DEV-TESTING-RG
ServiceOfferingMemory 8192
ServiceOfferingCores 2
TemplateIsWindowsTemplate True
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SupportedMachineGenerations Gen1,Gen2
<!--NeedCopy-->

Identificar recursos creados por MCS

A continuación se muestran las etiquetas que MCS añade a los recursos. Las etiquetas de la tabla se representan como “clave”:”valor”.

Nota:

Una VM no es visible en el inventario de Citrix si se añade una etiqueta CitrixResource para identificarla como un recurso creado por MCS. Puede quitar o cambiar el nombre de la etiqueta para que sea visible.

Quitar etiquetas

Al crear un catálogo o una VM, se crean etiquetas en los siguientes recursos:

• Grupo de recursos
• Máquina virtual
• Disco del SO
• Disco de identidad
• Interfaz de red
• Cuenta de almacenamiento

Puede eliminar máquinas virtuales y catálogos de máquinas de la base de datos de Citrix y eliminar etiquetas. Puede usar:

• Remove-ProvVM con el parámetro ForgetVM para eliminar máquinas virtuales y etiquetas de una sola máquina virtual o de una lista de máquinas virtuales de un catálogo de máquinas.
• Remove-ProvScheme con el parámetro ForgetVM para eliminar un catálogo de máquinas de la base de datos de Citrix y etiquetas de un catálogo de máquinas completo.

Esta función solo se aplica a las máquinas virtuales persistentes.

Para ello:

1. Abra una ventana de PowerShell.
2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

3. Ejecute Remove-ProvVM para eliminar máquinas virtuales de la base de datos de Citrix y etiquetas de las máquinas virtuales. Por ejemplo:

   Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
   <!--NeedCopy-->
   

4. Ejecute Remove-ProvScheme para eliminar el catálogo de máquinas de la base de datos de Citrix y las etiquetas de los catálogos de máquinas. Por ejemplo:

   Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM
   <!--NeedCopy-->
   

   Nota:

   Después de usar el parámetro ForgetVM en Remove-ProvScheme, MCS elimina todas las instantáneas, incluida la instantánea del disco base, si el esquema de aprovisionamiento está presente en un grupo de recursos propio (BYORG) o en un grupo de recursos administrado por Citrix.

Más información

• Crear y administrar conexiones y recursos
• Conexión a Microsoft Azure
• Crear catálogos de máquinas
• Crear un catálogo de Microsoft Azure
• Administrar catálogos de máquinas