Documentación de productos
Citrix DaaS
Ver PDF

Administrar un catálogo de Microsoft Azure

September 15, 2025
Contribución de: 
C C

Nota: No

En julio de 2023, Microsoft cambió 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 hace referencia a Microsoft Entra ID.

Administrar catálogos de máquinas describe los asistentes con los que se administra un catálogo de máquinas. La siguiente información incluye detalles específicos de los entornos de nube de Microsoft Azure Resource Manager.

Nota: No

Antes de administrar un catálogo de Microsoft Azure, debe terminar de crear un catálogo de Microsoft Azure. Consulte Crear un catálogo de Microsoft Azure.

Cambio del tipo de almacenamiento a un nivel inferior al apagar una máquina virtual

Puede ahorrar costes de almacenamiento al cambiar el tipo de almacenamiento de un disco administrado a un nivel inferior cuando apaga una máquina virtual. Para ello, utilice la propiedad personalizada StorageTypeAtShutdown.

El tipo de almacenamiento del disco cambia a un nivel inferior (como se especifica en la propiedad personalizada StorageTypeAtShutdown) al apagar la máquina virtual. Después de encender la máquina virtual, el tipo de almacenamiento vuelve a ser el original (como se especifica en la propiedad personalizada StorageType o en la propiedad personalizada WBCDiskStorageType).

Importante:

  • El disco no existe hasta que la máquina virtual se encienda al menos una vez. Por lo tanto, no puede cambiar el tipo de almacenamiento la primera vez que enciende la máquina virtual.
  • Es posible que las máquinas virtuales tarden un poco más en iniciarse después de cambiar el tipo de almacenamiento a un nivel inferior.

Requisitos

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

Restricción

  • Según informa Microsoft, solo se puede cambiar el tipo de disco dos veces al día. Consulte el documento de Microsoft. Según informa Citrix, la actualización de StorageType tiene lugar cada vez que hay una acción de inicio o desasignación para la máquina virtual. Por lo tanto, limite la cantidad de acciones de energía por máquina virtual a dos veces al día. Por ejemplo, una acción de energía por la mañana para iniciar la máquina virtual y otra por la noche para desasignarla.

Cambiar el tipo de almacenamiento a un nivel inferior

Antes de continuar con los pasos, consulte los Requisitos y Restricciones.

  1. Agregue la propiedad personalizada StorageTypeAtShutdown, establezca el valor en Standard_LRS (HDD) y cree un catálogo con New-ProvScheme.

    Nota: No

    Si StorageTypeAtShutdown tiene un valor que no sea en blanco 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: No

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

  2. Apague la máquina virtual y compruebe el tipo de almacenamiento de la máquina virtual en Azure Portal. El tipo de almacenamiento del disco cambia a un nivel inferior, tal como se especifica en la propiedad personalizada StorageTypeAtShutdown.
  3. Encienda la máquina virtual. El tipo de almacenamiento del disco vuelve al tipo de almacenamiento mencionado en:
    • Propiedad StorageType personalizada para disco de SO
    • Propiedad WBCDiskStorageType personalizada para disco WBC solo si la especifica en CustomProperties. De lo contrario, se 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 Restricciones.

Use Set-ProvScheme para aplicar StorageTypeAtShutdown a las nuevas máquinas virtuales agregadas a un catálogo existente.

Ejemplo de configuración de propiedades personalizadas al agregar una máquina virtual 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 máquinas virtuales existentes a un nivel inferior al apagarlas

Antes de continuar con los pasos, consulte los Requisitos y Restricciones.

Puede ahorrar costes de almacenamiento si cambia el tipo de almacenamiento de las máquinas virtuales existentes a un nivel inferior cuando estas están apagadas.

Para cambiar el tipo de almacenamiento de las máquinas de un catálogo a un nivel inferior cuando las VM estén apagadas:

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

      $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 máquinas virtuales agregadas después de ejecutar Set-ProvScheme.

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

  6. Actualice las máquinas virtuales existentes para habilitar StorageTypeAtShutdown.

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  7. La próxima vez que encienda las máquinas, se actualizará la propiedad StorageTypeAtShutdown de las máquinas. El tipo de almacenamiento cambiará la próxima vez que se apague.

  8. Ejecute el siguiente comando para ver el valor de StorageTypeAtShutdown de cada máquina virtual de 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-->

Convertir los catálogos MCS antiguos de Azure en catálogos basados en perfiles de máquina

Para convertir un catálogo de máquinas no basado en perfiles de máquina en un catálogo de máquinas basado en perfiles de máquina, siga estos pasos:

  1. En la página Catálogos de máquinas, haga clic con el botón secundario en el nombre del catálogo de máquinas que quiere convertir y, a continuación, seleccione Modificar catálogo de máquinas.
  2. En la página Modificar catálogo de máquinas > Perfil de máquina, seleccione la casilla Usar un perfil de máquina (obligatorio para Azure Active Directory).
  3. Haga clic en Seleccione un perfil de máquina.
  4. En la página Seleccione un perfil de máquina, seleccione una máquina virtual o una plantilla de inicio para usarlas como perfil de máquina.
  5. Si algunos parámetros actuales difieren de los nuevos parámetros del perfil de máquina, seleccione la opción correspondiente a los parámetros que quiere usar y haga clic en Continuar.
  6. Haga clic en Aplicar.

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 Set-ProvVMUpdateTimeWindowde PowerShell, puede aplicar el esquema de aprovisionamiento actual a una máquina o un conjunto de máquinas persistentes o no persistentes. 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 estas propiedades personalizadas:

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

Nota: No

  • En entornos de Azure, solo puede actualizar las propiedades personalizadas StorageType, WBCDiskStorageType e IdentityDiskStorageType de un catálogo mediante un disco administrado.
  • Si ejecuta Set-ProvVMUpdateTimeWindow dos veces, se aplicará el comando más reciente.

Puede actualizar:

  • Una sola máquina virtual
  • Una lista de máquinas virtuales específicas o todas las máquinas virtuales asociadas a un ID de esquema de aprovisionamiento
  • Una lista de máquinas virtuales específicas o todas las máquinas virtuales asociadas a un nombre de esquema de aprovisionamiento (nombre del catálogo de máquinas)

Tras realizar los siguientes cambios en el esquema de aprovisionamiento, la instancia de máquina virtual se vuelve a crear para los catálogos persistentes en Azure:

  • Cambiar MachineProfile
  • Quitar LicenseType
  • Quitar DedicatedHostGroupId

Nota: No

El disco del sistema operativo de las máquinas existentes, junto con todos sus datos, permanecen tal cual y una nueva máquina virtual se conecta al disco.

Antes de actualizar las máquinas virtuales existentes:

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

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

  2. Actualice el esquema de aprovisionamiento. Por ejemplo:

    • Con 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 del perfil de la 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-->

    • Con solo oferta de servicios:

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

  3. Compruebe si la propiedad actual de la máquina virtual coincide con el esquema de aprovisionamiento actual y si hay alguna acción de actualización pendiente en la máquina virtual. Por ejemplo:

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

    También puede encontrar máquinas con una versión en particular. 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 próximo reinicio:

  1. Ejecute estos comandos para actualizar las máquinas existentes y hacer que las actualizaciones se apliquen en el próximo reinicio.

    • Para actualizar todas las máquinas. 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 las máquinas según el resultado de Get-ProvVM. Por ejemplo:

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

    Nota: No

    • 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. Busque las máquinas que tienen 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 en las propiedades se aplicarán a las máquinas existentes. Puede comprobar el estado de la actualización con el siguiente comando. Por ejemplo:

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

Para programar la actualización de una máquina virtual a los parámetros de aprovisionamiento más recientes la próxima vez que se inicie en la franja horaria programada:

  1. Ejecute los comandos siguientes:

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

    • 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 de la programación 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 máquina virtual. Si enciende la máquina después de la franja horaria programada, no se aplica la actualización de la configuración. Si enciende la máquina durante la franja horaria programada

    • 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 configuración
      • reinicia la máquina, se aplica la actualización de la configuración

Para cancelar la actualización de configuración:

También puede cancelar una actualización de configuración de una sola máquina virtual, varias máquinas virtuales o todo un catálogo. Para cancelar una actualización de configuración:

  1. Ejecute Clear-ProvVMUpdateTimeWindow. Por ejemplo:

    • Para cancelar la actualización de configuración programada para una sola máquina virtual:

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

    • Para cancelar la actualización de configuración programada para varias máquinas virtuales:

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

Nota: No

Las máquinas virtuales deben ser del mismo catálogo.

Cambiar el cifrado del disco

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

  • Crear un catálogo de máquinas MCS con un conjunto de cifrado de disco (DES) distinto 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-->

  • Cambiar el tipo de cifrado del disco de una clave DES a otra clave DES de un catálogo de máquinas de MCS existente y de las máquinas virtuales existentes mediante los comandos Set-ProvScheme y Set-ProvVMUpdateTimeWindow. Después de reiniciar las máquinas virtuales, puede 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-->

  • Actualizar una máquina virtual y un catálogo de máquinas de MCS que antes no estuvieran habilitados para CMEK para que tengan cifrado (DES) con clave de cifrado administrada por el cliente (CMEK), cifrado de disco en el host o el doble cifrado 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 discos de Azure en el host y Cifrado doble en disco administrado.

  • Actualizar máquinas virtuales y un catálogo de máquinas de MCS existentes para que no estén cifrados y que anteriormente estuvieran 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-->

  • Habilitar el cifrado de discos con un dispositivo de punto final privado (un catálogo de máquinas de MCS que use una conexión de host habilitada con ProxyHypervisorTrafficThroughConnector). Para obtener más información sobre ProxyHypervisorTrafficThroughConnector, consulte Crear un entorno seguro para el tráfico administrado por Azure. Para obtener información sobre cómo habilitar el cifrado de disco con dispositivos de punto final privados, consulte Habilitar el cifrado de disco con dispositivos de punto final privados.

Habilitar el cifrado de disco con dispositivos de punto final privados

Según la limitación de Azure, actualmente no se puede usar el cifrado del lado del servidor con claves administradas por el cliente para dispositivos de punto final privados. Sin embargo, puede actualizar máquinas virtuales y un catálogo de máquinas de MCS con dispositivos de punto final privados para cifrarlos con la clave DES.

Actualizar un catálogo de máquinas existente con dispositivos de punto final privados

Estos son los pasos detallados para actualizar un catálogo de máquinas existente con dispositivos de punto final privados:

  1. Cree un catálogo sin cifrado de disco mediante ProxyHypervisorTrafficThroughConnector. Para obtener más información sobre ProxyHypervisorTrafficThroughConnector, consulte Crear un entorno seguro para el tráfico administrado por Azure.

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

    Nota: No

    DiskEcryptionSetId se puede configurar mediante CustomProperties o MachineProfile. Cuando se define en CustomProperties y 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: Use una máquina virtual que tenga habilitado el cifrado de disco o una especificación de plantilla con parámetros de cifrado de disco:

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

    Como alternativa, puede actualizar el perfil de una máquina mediante Studio.

  3. Ejecute Set-ProvVMUpdateTimeWindow para actualizar las máquinas virtuales del catálogo. Por ejemplo:

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  4. Después de reiniciar las máquinas virtuales, puede ver el cifrado de disco actualizado en los discos de las máquinas virtuales en Azure Portal.

  5. Ejecute Set-ProvScheme para anular el cifrado del disco antes de agregar nuevas máquinas virtuales de catálogo.

    Nota: No

    Este paso es obligatorio porque está actualizando un catálogo de dispositivos de punto final privados. Si no sigue este paso, aparecerán errores al intentar agregar nuevas máquinas virtuales 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 máquinas virtuales de catálogo individuales

Los pasos detallados para actualizar las máquinas virtuales de catálogo individuales son los siguientes:

  1. Cree un catálogo sin cifrado de disco mediante ProxyHypervisorTrafficThroughConnector. Para obtener más información sobre ProxyHypervisorTrafficThroughConnector, consulte Crear un entorno seguro para el tráfico administrado por Azure.

  2. Ejecute Set-ProvVM para actualizar la máquina virtual del catálogo con DiskEncryptionSetId.

    Nota: No

    DiskEcryptionSetId se puede configurar mediante 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 máquinas virtuales del catálogo. Por ejemplo:

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->
  4. Después de reiniciar las máquinas virtuales, puede ver el cifrado de disco actualizado en los discos de las máquinas virtuales en Azure Portal.
  5. Agregue nuevas VM al catálogo.

Usar un disco temporal como disco WBC para los catálogos existentes

Puede usar un disco temporal de Azure como disco de caché de reescritura (WBC) para los catálogos de máquinas MCS existentes. Use el comando Set-ProvScheme de PowerShell para actualizar los catálogos y las máquinas virtuales.

Requisitos previos

El catálogo debe cumplir las siguientes condiciones:

Nota: No

Si el catálogo no cumple con los siguientes requisitos, el disco WBC no se coloca dentro del disco temporal.

  • E/S de MCS está habilitada: Las propiedades WriteBackCacheMemorySize, WriteBackCacheDiskSize y UseWriteBackCache personalizadas están habilitadas.
  • El disco efímero de SO no está habilitado.
  • WBC no es persistente: PersistWBC es false.
  • UseTempDiskForWBC es nulo o false.
  • El tamaño del disco temporal debe ser mayor que el tamaño total de (tamaño del disco de caché de reescritura + espacio reservado para el archivo de paginación + 1 GB de espacio de búfer).

Importante:

No se permite cambiar una oferta de servicios de una con un disco temporal a otra sin él, o viceversa.

Actualizar los catálogos existentes

Para actualizar un catálogo, ejecute estos comandos:

  1. Ejecute Set-ProvScheme en el catálogo para actualizar UseTempDiskForWBC con el valor true. Por ejemplo:

      Set-ProvScheme -ProvisioningSchemeName name -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=`"Standard_LRS`"/><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"ManagedDisksPreview`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"UseTempDiskForWBC`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"False`"/></CustomProperties>"
<!--NeedCopy-->

  2. Agregue máquinas nuevas al catálogo y enciéndalas. Las nuevas máquinas virtuales tienen un disco WBC dentro del disco temporal.

Obtener información de las máquinas virtuales de Azure, instantáneas, el disco del sistema operativo y la definición de imagen de la galería

Puede mostrar información de una máquina virtual de Azure, incluidos el disco y el tipo del sistema operativo, la instantánea y la definición de imágenes de 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: el tipo de máquina virtual, el disco del sistema operativo, la información de la imagen de la galería y la información sobre el tipo de SO. Si se establece TemplateIsWindowsTemplate en True, se indica que el tipo de sistema operativo es Windows y si se establece TemplateIsWindowsTemplate en False, se indica que el tipo de sistema operativo es Linux.

Sugerencia:

La información que muestra la propiedad TemplateIsWindowsTemplate de PowerShell se deriva de la API de Azure. A veces, es posible que este campo esté vacío. Por ejemplo, una instantánea de un disco de datos no contiene el campo TemplateIsWindowsTemplate porque no se puede obtener el tipo de sistema operativo de una instantánea.

Por ejemplo, establezca el parámetro de VM de Azure AdditionData 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-->

Obtener información del nombre de la región de las máquinas virtuales de Azure, los discos administrados, las instantáneas, el VHD de Azure y las plantillas de ARM

Puede mostrar la información del nombre de la región de una VM de Azure, discos administrados, instantáneas, el VHD de Azure y plantillas de ARM. Esta información se muestra para los recursos de la imagen maestra cuando se asigna un catálogo de máquinas. Una propiedad de PowerShell denominada RegionName muestra la información del nombre de la región al ejecutar el comando de PowerShell con el parámetro AdditionalData.

Por ejemplo, use este comando de PowerShell para obtener información de una VM en Azure.

  PS C:\Windows\system32> (get-item XDHyp:\HostingUnits\myAzureNetwork\image.folder\hu-dev-testing-rg.resourcegroup\hu-dev-tsvda.vm).AdditionalData
  Key Value
  HardDiskSizeGB 127
  ResourceGroupName HU-DEV-TESTING-RG
  RegionName East US
  TemplateIsWindowsTemplate True
  LicenseType
  ServiceOfferingDescription Standard_B2ms
  ServiceOfferingMemory 8192
  ServiceOfferingCores 2
  SupportedMachineGenerations Gen1,Gen2
  ServiceOfferingWithTemporaryDiskSizeInMb 16384
  SecurityType
  SecureBootEnabled
  VTpmEnabled
<!--NeedCopy-->

Identificar los recursos creados por MCS

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

Resource name Etiqueta
Disco de ID “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Imagen “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
NIC “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Disco de SO “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
máquina virtual de preparación “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Instantánea publicada “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Resource group “CitrixResource” : “Internal”
  CitrixSchemaVersion: 2.0
  “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Cuenta de almacenamiento “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
VM en catálogo “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”
Disco WBC “CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
  “CitrixResource” : “Internal”

Nota: No

Una máquina virtual no está visible en el inventario de Citrix si se agrega una etiqueta CitrixResource para identificarla como un recurso creado por MCS. Puede quitar la etiqueta o cambiarle el nombre para que sea visible.

Quitar etiquetas

Al crear un catálogo o una máquina virtual, se crean etiquetas en estos recursos:

  • Resource group
  • Máquina virtual
  • Disco de SO
  • Disco de identidad
  • Interfaz de red
  • Cuenta de almacenamiento

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

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

Esta función solo se puede aplicar a máquinas virtuales persistentes.

Para hacer esto:

  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 Citrix y etiquetas de 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 etiquetas de catálogos de máquinas. Por ejemplo:

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

    Nota: No

    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 su propio grupo de recursos (BYORG) o en el grupo de recursos administrado por Citrix.

Más información

Administrar un catálogo de Microsoft Azure
September 15, 2025
Contribución de: 
C C
September 15, 2025
Contribución de: 
C 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.