Citrix Virtual Apps and Desktops

Administrar un catálogo de Microsoft Azure

January 3, 2024

Contribución de:

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:

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.

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

Puede utilizar una máquina virtual o una especificación de plantilla como entrada de perfil 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. Las máquinas virtuales existentes y las máquinas virtuales nuevas agregadas al catálogo toman los valores de las propiedades del perfil de la máquina a menos que se sobrescriban con propiedades personalizadas explícitas.

Nota:

Un catálogo de máquinas existente basado en perfiles de máquina no se puede cambiar a un catálogo de máquinas no basado en perfiles de máquina.

Para hacerlo:

Cree un catálogo de máquinas persistente o no persistente con máquinas virtuales y sin un perfil de máquina.
Abra la ventana de PowerShell.

Ejecute el comando Set-ProvScheme para aplicar los valores de las propiedades del perfil de la máquina a las nuevas máquinas virtuales agregadas al catálogo de máquinas. Por ejemplo:

Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits<HostingUnitName>\machineprofile.folder<ResourceGroupName><TemplateSpecName><VersionName>
<!--NeedCopy-->

Ejecute el comando Set-ProvVMUpdateTimeWindow para aplicar los valores de las propiedades del perfil de la máquina a las máquinas virtuales existentes del catálogo de máquinas. Por ejemplo:
```
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName xxxx -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1

```
Encienda las máquinas virtuales existentes para obtener los valores de las propiedades del perfil de máquina.

Conservar una máquina virtual aprovisionada durante los ciclos de apagado y encendido

Elija si quiere conservar una máquina virtual aprovisionada al apagar y encender. Utilice el parámetro New-ProvScheme CustomProperties de PowerShell. Este parámetro admite una propiedad adicional, PersistVm, que sirve para determinar si una máquina virtual aprovisionada persiste durante los ciclos de energía. Establezca la propiedad PersistVm en true para conservar una máquina virtual cuando se apague, o bien establezca la propiedad en false para asegurarse de que la máquina virtual no se conserve al apagarse.

Nota:

La propiedad PersistVm solo se aplica a los esquemas de aprovisionamiento con las propiedades CleanOnBoot y UseWriteBackCache habilitadas. Si no se especifica la propiedad PersistVm para máquinas virtuales no persistentes, se eliminan del entorno de Azure al apagarse.

En el ejemplo siguiente, el parámetro New-ProvScheme CustomProperties establece la propiedad PersistVm en true:

<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="Standard_LRS" />
<Property xsi:type="StringProperty" Name="PersistWBC" Value="false" />
<Property xsi:type="StringProperty" Name="PersistOsDisk" Value="true" />
<Property xsi:type="StringProperty" Name="PersistVm" Value="true" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="demo-resourcegroup" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
</CustomProperties>
<!--NeedCopy-->

En el siguiente ejemplo, el parámetro New-ProvScheme CustomProperties conserva la caché de reescritura estableciendo PersistVM en true:

 New-ProvScheme
 -AzureAdJoinType "None"
 -CleanOnBoot
 -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=`"Standard_LRS`" /><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"false`" /><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"true`" /><Property xsi:type=`"StringProperty`" Name=`"PersistVm`" Value=`"true`" /><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"demo-resourcegroup`" /><Property xsi:type=`"StringProperty`" Name=`"LicenseType`" Value=`"Windows_Client`" /></CustomProperties>"
 -HostingUnitName "demo"
 -IdentityPoolName "NonPersistent-MCSIO-PersistVM"
 -MasterImageVM "XDHyp:\HostingUnits\demo\image.folder\scale-test.resourcegroup\demo-snapshot.snapshot"
 -NetworkMapping @ {"0"="XDHyp:\HostingUnits\demo\virtualprivatecloud.folder\East US.region\virtualprivatecloud.folder\ji-test.resourcegroup\jitest-vnet.virtualprivatecloud\default.network"}
-ProvisioningSchemeName "NonPersistent-MCSIO-PersistVM"
 -ServiceOffering "XDHyp:\HostingUnits\demo\serviceoffering.folder\Standard_B2ms.serviceoffering" -UseWriteBackCache
 -WriteBackCacheDiskSize 127
 -WriteBackCacheMemorySize 256
 <!--NeedCopy-->

Consejo:

La propiedad PersistVm determina si se debe conservar una máquina virtual aprovisionada. La propiedad PersistOsdisk determina si se debe conservar el disco del sistema operativo. Para conservar una máquina virtual aprovisionada, conserve primero el disco del sistema operativo. No elimine el disco del SO sin eliminar antes la máquina virtual. Puede utilizar la propiedad PersistOsdisk sin especificar el parámetro PersistVm.

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

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

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.

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 la Restricción.

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

Nota:

Si StorageTypeAtShutdown tiene algún valor que no esté vacío o no sea Standard_LRS (HDD), la operación fallará.

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:

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

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 pasa a un nivel inferior, tal y como se especifica en la propiedad StorageTypeAtShutdown personalizada.
Encienda la máquina virtual. El tipo de almacenamiento del disco vuelve al tipo de almacenamiento mencionado en:
- Propiedad StorageType personalizada para el disco del sistema operativo
- Propiedad WBCDiskStorageType personalizada para el disco WBC solo si la 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.

Use Set-ProvScheme para agregar una máquina virtual a un catálogo existente. La función se aplica a las nuevas máquinas virtuales que se agregan después de ejecutar Set-ProvScheme. Las máquinas existentes no se ven afectadas.

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 la Restricción.

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 ello, utilice la propiedad StorageTypeAtShutdown personalizada.

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

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

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

Actualice el esquema de aprovisionamiento del catálogo existente. La actualización se aplica a las nuevas máquinas virtuales que se agregan después de ejecutar Set-ProvScheme.
```
Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties

```

Actualice las máquinas virtuales existentes para habilitar StorageTypeAtShutdown.

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

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.

Ejecute el siguiente comando para ver el valor 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-->

Personalizar el comportamiento de encendido en caso de error en el cambio del tipo de almacenamiento

Al encenderse, el tipo de almacenamiento de un disco administrado puede no cambiar al tipo deseado debido a un error de Azure. En estos casos, la máquina virtual permanecería apagada y se le enviaría un mensaje de error. Sin embargo, puede optar por encender la máquina virtual incluso cuando no se pueda restaurar el almacenamiento al tipo configurado o mantener la máquina virtual apagada.

Si configura la propiedad personalizada FailSafeStorageType como verdadera (configuración predeterminada) o no la especifica en los comandos New-ProvScheme y Set-ProvScheme:
- Al encenderla, la máquina virtual se enciende con un tipo de almacenamiento incorrecto.
- Al apagarla, la máquina virtual permanece apagada con un tipo de almacenamiento incorrecto.
Si configura la propiedad personalizada FailSafeStorageType como falsa en los comandos New-ProvScheme o Set-ProvScheme:
- Al encenderla, la máquina virtual permanece apagada con un tipo de almacenamiento incorrecto.
- Al apagarla, la máquina virtual permanece apagada con un tipo de almacenamiento incorrecto.

Para crear de un catálogo de máquinas:

Abra una ventana de PowerShell.
Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
Cree un grupo de identidades si aún no se ha creado.

Agregue la propiedad personalizada en New-ProvScheme. Por ejemplo:

New-ProvScheme -HostingUnitName "Azure-Resources-1" -IdentityPoolName "name" -InitialBatchSizeHint 1
-MasterImageVM "XDHyp:\HostingUnits\Azure-Resources-1\image.folder\abc.resourcegroup\def.snapshot"
-NetworkMapping @{"0"="XDHyp:\HostingUnits\Azure-Resources-1\ght.folder\abc.resourcegroup\abc-vnet.virtualprivatecloud\default.network"}
-ProvisioningSchemeName "name"
-ServiceOffering "XDHyp:\HostingUnits\Azure-Resources-1\serviceoffering.folder\Standard_DS2_v2.serviceoffering"
-CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
<Property xsi:type=`"StringProperty`" Name=`"StorageType`" Value=`"Premium_LRS`" />
<Property xsi:type=`"StringProperty`" Name=`"StorageTypeAtShutdown`" Value=`"Standard_LRS`" />
<Property xsi:type=`"StringProperty`" Name=`"FailSafeStorageType`" Value=`"true`" />
</CustomProperties>"
<!--NeedCopy-->

Cree el catálogo de máquinas Para obtener información sobre cómo crear un catálogo con el SDK de PowerShell remoto, consulte https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

Para actualizar un catálogo de máquinas e incluir la propiedad personalizada FailSafeStorageType. Esta actualización no afecta a las máquinas virtuales existentes.

Actualice la propiedad personalizada en el comando Set-ProvScheme. Por ejemplo:

   Set-ProvScheme -ProvisioningSchemeName <String> -CustomProperties "
   <CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`">
   <Property xsi:type=`"StringProperty`" Name=`"StorageType`" Value=`"Premium_LRS`" />
   <Property xsi:type=`"StringProperty`" Name=`"IdentityDiskStorageType`" Value=`"Premium_LRS`" />
   <Property xsi:type=`"StringProperty`" Name=`"FailSafeStorageType`" Value=`"false`" />
   </CustomProperties>"
   <!--NeedCopy-->

Para aplicar el cambio realizado en Set-ProvScheme a las máquinas virtuales existentes, ejecute el comando Set-ProvVMUpdateTimeWindow mediante los parámetros -StartsNow y -DurationInMinutes -1.

Ejecute el comando Set-ProvVMUpdateTimeWindow mediante los parámetros -StartsNow y -DurationInMinutes -1. Por ejemplo:

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

Reinicie las máquinas virtuales.

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-ProvVMUpdateTimeWindow de 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:

Solo puede actualizar las propiedades personalizadas StorageType, WBCDiskStorageType y IdentityDiskStorageType de un catálogo mediante un disco administrado en entornos de Azure.

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:

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:

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

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

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

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

```
También puede encontrar máquinas con una versión en particular. Por ejemplo,
```
Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion

```

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

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
 
```
- Para actualizar una lista de máquinas específicas. Por ejemplo,
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
 
```
- 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
 
```
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 ningún límite superior en la ventana de tiempo de la programación.

Busque las máquinas que tienen una actualización programada. Por ejemplo,

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

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

```

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:

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
 
```
- 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
 
```
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 de la programación es la hora actual.
- DurationInMinutes es opcional. El valor predeterminado es de 120 minutos. Un número negativo (por ejemplo, -1) indica que no hay ningún límite superior en la ventana de tiempo de la programación.

Compruebe el estado de la actualización.

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

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 la 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:

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”
  
```
- Para cancelar la actualización de configuración programada para varias máquinas virtuales:
```
 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 
```
  Nota:
  
  Las máquinas virtuales deben ser del mismo catálogo.

Actualizar propiedades de máquinas virtuales individuales

Puede actualizar propiedades de máquinas virtuales individuales en catálogos de máquinas de MCS persistentes mediante el comando de PowerShell Set-ProvVM. Sin embargo, las actualizaciones no se aplican de forma inmediata. Debe configurar el intervalo de tiempo mediante el comando de PowerShell Set-ProvVMUpdateTimeWindow para que se apliquen las actualizaciones.

Esta implementación le ayuda a administrar máquinas virtuales individuales de manera 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 máquina virtual
Conservar las propiedades actualizadas en una máquina virtual después de actualizar el catálogo de máquinas
Revertir las actualizaciones de configuración aplicadas a una máquina virtual

Antes de actualizar las propiedades de una máquina virtual:

Abra una ventana de PowerShell.
Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.
Compruebe la configuración del catálogo de máquinas existente. Por ejemplo:
```
Get-ProvScheme -ProvisioningSchemeName AzureCatalog

```
Compruebe la configuración de la máquina virtual en la que quiere aplicar las actualizaciones. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```

Actualizar propiedades de una máquina virtual

Haga lo siguiente para actualizar las propiedades de una máquina virtual:

Apague la máquina virtual en la que quiera aplicar las actualizaciones.

Actualice las propiedades de la máquina virtual. Por ejemplo, si quiere actualizar la propiedad personalizada de tipo de almacenamiento (StorageType) de la máquina virtual, ejecute lo siguiente:

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

Puede actualizar propiedades de dos máquinas virtuales de 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 de forma inmediata.

Obtenga la lista de propiedades que se especificaron para actualizarse y la versión de configuración. Por ejemplo:
```
Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Compruebe el valor de la propiedad Version y las propiedades que se actualizarán (en este caso, StorageType).
Compruebe la versión de la configuración. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Compruebe el valor de la propiedad ProvVMConfigurationVersion. La actualización aún no se ha aplicado. La máquina virtual aún tiene la configuración anterior.
Solicite una actualización programada. Por ejemplo:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
 
```
Para obtener más información sobre las actualizaciones programadas, consulte Actualizar las máquinas aprovisionadas al estado actual del esquema de aprovisionamiento.

Nota:

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

Reinicie la VM. Por ejemplo:

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

Compruebe la versión de la configuración. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Compruebe el valor de la propiedad ProvVMConfigurationVersion. Ahora la actualización sí se aplica. La máquina virtual ya tiene la nueva configuración.
Para aplicar más actualizaciones de configuración en la máquina virtual, apáguela y repita los pasos.

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

Haga lo siguiente para mantener las propiedades actualizadas en una máquina virtual:

Apague la máquina virtual en la que quiera aplicar las actualizaciones.
Actualice el catálogo de máquinas. Por ejemplo, si quiere cambiar el tamaño de la máquina virtual (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' />..."

```
Obtener los detalles de configuración del catálogo de máquinas. Por ejemplo:
```
Get-ProvScheme -ProvisioningSchemeName AzureCatalog

```
Ahora el valor de ProvisioningSchemeVersion se incrementa en uno. También se actualizan el tamaño y el tipo de almacenamiento de la máquina virtual.

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

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 especificados una etiqueta y un tamaño de máquina virtual diferentes (ServiceOffering).

Obtenga la lista de propiedades que tendrá la máquina virtual después de combinar las actualizaciones de configuración de la máquina virtual con las actualizaciones del catálogo de máquinas. Por ejemplo:
```
Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Nota:

Cualquier actualización de la máquina virtual supeditará las actualizaciones realizadas en el catálogo de máquinas.

Solicite una actualización programada para la máquina virtual. Por ejemplo:

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

Reinicie la VM. Por ejemplo:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

```
La máquina virtual mantiene su tamaño de máquina virtual actualizado tal y 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 máquina virtual. Sin embargo, el tipo de almacenamiento se deriva del esquema de aprovisionamiento más reciente.
Obtenga la versión de configuración de la máquina virtual. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Ahora, ProvisioningSchemeVersion y ProvVMConfigurationVersion muestra la versión más reciente.

Revertir las actualizaciones de configuración aplicadas a una máquina virtual

Después de aplicar las actualizaciones a una máquina virtual, apáguela.

Ejecute el siguiente comando para quitar las actualizaciones que se aplican en la máquina virtual. Por ejemplo:

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

Solicite una actualización programada para la máquina virtual. Por ejemplo:

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

Reinicie la VM. Por ejemplo:

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

Compruebe la versión de configuración de la máquina virtual. Por ejemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Ahora, el valor de ProvVMConfigurationVersion es la versión de configuración del catálogo de máquinas.

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. Al establecer TemplateIsWindowsTemplate en True, significa que el tipo de sistema operativo es Windows; al establecer TemplateIsWindowsTemplate en False, significa que el tipo de sistema operativo es Linux.

Consejo:

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 el tipo de sistema operativo no se puede obtener de una instantánea.

Por ejemplo, establezca el parámetro AdditionData de la máquina virtual 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 los recursos creados por MCS

A continuación, se muestran las etiquetas que MCS agrega a los recursos. 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”
PrepVM	“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:

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.

Más información

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

Administrar un catálogo de Microsoft Azure

January 3, 2024

Contribución de:

January 3, 2024

Contribución de:

En este artículo

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
Conservar una máquina virtual aprovisionada durante los ciclos de apagado y encendido
Cambio del tipo de almacenamiento a un nivel inferior al apagar una máquina virtual
Personalizar el comportamiento de encendido en caso de error en el cambio del tipo de almacenamiento
Actualizar las máquinas aprovisionadas al estado actual del esquema de aprovisionamiento
Actualizar propiedades de máquinas virtuales individuales
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
Identificar los recursos creados por MCS
Más información

Administrar un catálogo de Microsoft Azure

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

Conservar una máquina virtual aprovisionada durante los ciclos de apagado y encendido

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

Requisitos

Restricción

Cambiar el tipo de almacenamiento a un nivel inferior

Aplicar StorageTypeAtShutdown a un catálogo existente

Cambiar el tipo de almacenamiento de las máquinas virtuales existentes a un nivel inferior al apagarlas

Personalizar el comportamiento de encendido en caso de error en el cambio del tipo de almacenamiento

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

Actualizar propiedades de máquinas virtuales individuales

Actualizar propiedades de una máquina virtual

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

Revertir las actualizaciones de configuración aplicadas a una máquina virtual

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

Identificar los recursos creados por MCS

Más información

En este artículo

Aplicar `StorageTypeAtShutdown` a un catálogo existente