Gérer un catalogue Microsoft Azure

Remarque :

Depuis juillet 2023, Microsoft a renommé Azure Active Directory (Azure AD) en Microsoft Entra ID. Dans ce document, toute référence à Azure Active Directory, Azure AD ou AAD fait désormais référence à Microsoft Entra ID.

(/fr-fr/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-manage.html) décrit les assistants qui gèrent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements cloud Microsoft Azure Resource Manager.

Remarque :

Avant de gérer un catalogue Microsoft Azure, vous devez terminer la création d’un catalogue Microsoft Azure. Consultez (/fr-fr/citrix-virtual-apps-desktops/2407/install-configure/machine-catalogs-create/create-machine-catalog-citrix-azure.html).

Changer le type de stockage vers un niveau inférieur lorsqu’une VM est arrêtée

Vous pouvez réduire les coûts de stockage en basculant le type de stockage d’un disque géré vers un niveau inférieur lorsque vous arrêtez une VM. Pour ce faire, utilisez la propriété personnalisée StorageTypeAtShutdown.

Le type de stockage du disque passe à un niveau inférieur (tel que spécifié dans la propriété personnalisée StorageTypeAtShutdown) lorsque vous arrêtez la VM. Après avoir démarré la VM, le type de stockage revient à l’original (tel que spécifié dans la propriété personnalisée StorageType ou la propriété personnalisée WBCDiskStorageType).

Important :

Le disque n’existe pas tant que la VM n’a pas été démarrée au moins une fois. Par conséquent, vous ne pouvez pas modifier le type de stockage lors du premier démarrage de la VM.

Conditions requises

• Applicable à un disque géré. Cela implique que vous définissez la propriété personnalisée UseManagedDisks sur true.
• Applicable à un catalogue persistant et non persistant avec un disque de système d’exploitation persistant. Cela implique que vous définissez la propriété personnalisée persistOsDisk sur true.
• Applicable à un catalogue non persistant avec un disque WBC persistant. Cela implique que vous définissez la propriété personnalisée persistWBC sur true.

Restriction

• Selon Microsoft, vous ne pouvez modifier le type de disque que deux fois par jour. Consultez le document Microsoft. Selon Citrix, la mise à jour StorageType a lieu chaque fois qu’une action de démarrage ou de désallocation est effectuée pour la VM. Par conséquent, limitez le nombre d’actions d’alimentation par VM à deux par jour. Par exemple, une action d’alimentation le matin pour démarrer la VM et une le soir pour désallouer la VM.

Modifier le type de stockage vers un niveau inférieur

Avant de poursuivre les étapes, consultez les (#requirements) et la (#restriction).

1. Ajoutez la propriété personnalisée StorageTypeAtShutdown, définissez la valeur sur Standard_LRS (HDD) et créez un catalogue à l’aide de New-ProvScheme. Pour plus d’informations sur la création d’un catalogue à l’aide de PowerShell, consultez https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/.

   Remarque :

   Si StorageTypeAtShutdown a une valeur autre que vide ou Standard_LRS (HDD), l’opération échoue.

   Exemple de définition de propriétés personnalisées lors de la création d’un catalogue persistant :

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

   Exemple de définition de propriétés personnalisées lors de la création d’un catalogue non persistant :

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

   Remarque :

   Lorsque vous utilisez un profil de machine, la propriété personnalisée prévaut sur la propriété définie dans MachineProfile.

2. Arrêtez la VM et vérifiez le type de stockage de la VM dans le portail Azure. Le type de stockage du disque passe à un niveau inférieur, comme spécifié dans la propriété personnalisée StorageTypeAtShutdown.
3. Démarrez la VM. Le type de stockage du disque revient au type de stockage mentionné dans :
   • Propriété personnalisée StorageType pour le disque du système d’exploitation
   • Propriété personnalisée WBCDiskStorageType pour le disque WBC uniquement si vous la spécifiez dans CustomProperties. Sinon, elle revient au type de stockage mentionné dans StorageType.

Appliquer StorageTypeAtShutdown à un catalogue existant

Avant de poursuivre les étapes, consultez les Exigences et la Restriction.

Utilisez Set-ProvScheme pour ajouter une VM à un catalogue existant. La fonctionnalité s’applique aux nouvelles VM ajoutées après l’exécution de Set-ProvScheme. Les machines existantes ne sont pas affectées.

Exemple de définition de propriétés personnalisées lors de l’ajout d’une VM à un catalogue existant :

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

Modifier le type de stockage des VM existantes vers un niveau inférieur lors de l’arrêt

Avant de poursuivre les étapes, consultez les Exigences et la Restriction.

Vous pouvez réduire les coûts de stockage en modifiant le type de stockage des VM existantes vers un niveau inférieur lorsque les VM sont arrêtées. Pour ce faire, utilisez la propriété personnalisée StorageTypeAtShutdown.

Pour modifier le type de stockage des machines existantes dans un catalogue vers un niveau inférieur lorsque les VM sont arrêtées :

1. Ouvrez une fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.
3. Exécutez Get-Provscheme -ProvisioningSchemeName $CatalogName.

4. Modifiez la chaîne des propriétés personnalisées.

   $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. Mettez à jour le schéma de provisioning du catalogue existant. La mise à jour s’applique aux nouvelles VM ajoutées après l’exécution de Set-ProvScheme.

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

6. Mettez à jour les VM existantes pour activer StorageTypeAtShutdown.

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

7. Lorsque vous allumez les machines la prochaine fois, la propriété StorageTypeAtShutdown des machines est mise à jour. Le type de stockage change lors du prochain arrêt.

8. Exécutez la commande suivante pour afficher la valeur StorageTypeAtShutdown de chaque machine virtuelle d’un catalogue :

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

Mettre à jour les machines provisionnées vers l’état actuel du schéma de provisionnement

La commande Set-ProvScheme modifie le schéma de provisionnement. Cependant, elle n’affecte pas les machines existantes. À l’aide de la commande PowerShell Set-ProvVMUpdateTimeWindow, vous pouvez appliquer le schéma de provisionnement actuel à une machine ou un ensemble de machines existantes, persistantes ou non persistantes. Vous pouvez également planifier un créneau horaire pour les mises à jour de configuration des machines provisionnées MCS existantes. Toute mise sous tension ou redémarrage pendant le créneau horaire planifié applique une mise à jour planifiée du schéma de provisionnement à une machine. Actuellement, dans Azure, vous pouvez mettre à jour ServiceOffering, MachineProfile et les propriétés personnalisées suivantes :

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

Remarque :

• Vous ne pouvez mettre à jour que les propriétés personnalisées StorageType, WBCDiskStorageType et IdentityDiskStorageType pour un catalogue utilisant un disque géré dans les environnements Azure.
• Si vous exécutez Set-ProvVMUpdateTimeWindow deux fois, la commande la plus récente prend effet.

Vous pouvez mettre à jour :

• Une seule VM
• Une liste de VM spécifiques ou toutes les VM existantes associées à un ID de schéma de provisioning
• Une liste de VM spécifiques ou toutes les VM existantes associées à un nom de schéma de provisioning (nom de catalogue de machines)

Après avoir apporté les modifications suivantes au schéma de provisioning, l’instance de VM est recréée pour les catalogues persistants dans Azure :

• Modifier le MachineProfile
• Supprimer LicenseType
• Supprimer DedicatedHostGroupId

Remarque :

Le disque du système d’exploitation des machines existantes, ainsi que toutes ses données, reste tel quel et une nouvelle VM est attachée au disque.

Avant de mettre à jour les VM existantes :

1. Vérifiez la configuration des machines existantes. Par exemple,

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

2. Mettez à jour le schéma de provisioning. Par exemple,

   • Avec la VM comme entrée de profil de machine :

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

   • Avec la spécification de modèle comme entrée de profil de machine :

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

   • Avec seulement l’offre de service :

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

3. Vérifiez si la propriété actuelle de la VM correspond au schéma de provisionnement actuel et s’il y a une action de mise à jour en attente sur la VM. Par exemple,

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

   Vous pouvez également trouver des machines avec une version particulière. Par exemple,

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

Pour demander que les mises à jour des machines existantes soient appliquées au prochain redémarrage :

1. Exécutez les commandes suivantes pour mettre à jour les machines existantes et faire en sorte que les mises à jour soient appliquées au prochain redémarrage.

   • Pour mettre à jour toutes les machines existantes. Par exemple,

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

   • Pour mettre à jour une liste de machines spécifiques. Par exemple,

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

   • Pour mettre à jour les machines en fonction de la sortie de Get-ProvVM. Par exemple,

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

   Remarque :

   • StartsNow indique que l’heure de début planifiée est l’heure actuelle.
   • DurationInMinutes avec un nombre négatif (par exemple, –1) indique qu’il n’y a pas de limite supérieure pour la fenêtre de temps de la planification.

2. Recherchez les machines avec une mise à jour planifiée. Par exemple,

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

3. Redémarrez les machines. Lors du prochain démarrage, les modifications de propriétés sont appliquées aux machines existantes. Vous pouvez vérifier l’état mis à jour à l’aide de la commande suivante. Par exemple,

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

Pour planifier la mise à jour d’une VM vers les derniers paramètres de provisionnement lors de son prochain démarrage dans la fenêtre de temps planifiée :

1. Exécutez les commandes suivantes :

   • Pour planifier une mise à jour avec l’heure de début comme heure actuelle

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

   • Pour planifier une mise à jour le week-end

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

   Remarque :

   • VMName est facultatif. S’il n’est pas spécifié, la mise à jour est planifiée pour l’ensemble du catalogue.
   • Au lieu de StartTimeInUTC, utilisez StartsNow pour indiquer que l’heure de début de la planification est l’heure actuelle.
   • DurationInMinutes est facultatif. La valeur par défaut est 120 minutes. Un nombre négatif (par exemple, –1) indique qu’il n’y a pas de limite supérieure pour la fenêtre de temps de la planification.

2. Vérifiez l’état de la mise à jour.

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

3. Mettez la VM sous tension. Si vous mettez la machine sous tension après le créneau horaire planifié, la mise à jour de la configuration n’est pas appliquée. Si vous mettez la machine sous tension pendant le créneau horaire planifié,

   • Si la machine est hors tension et que

     • vous ne mettez pas la machine sous tension, la mise à jour de la configuration n’est pas appliquée
     • vous mettez la machine sous tension, la mise à jour de la configuration est appliquée

   • Si la machine est sous tension et que

     • vous ne redémarrez pas la machine, la mise à jour de la configuration n’est pas appliquée
     • vous redémarrez la machine, la mise à jour de la configuration est appliquée

Pour annuler la mise à jour de la configuration :

Vous pouvez également annuler une mise à jour de configuration d’une seule VM, de plusieurs VM ou d’un catalogue entier. Pour annuler une mise à jour de configuration :

1. Exécutez Clear-ProvVMUpdateTimeWindow. Par exemple :

   • Pour annuler la mise à jour de configuration planifiée pour une seule VM :

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

   • Pour annuler la mise à jour de configuration planifiée pour plusieurs VM :

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

     Remarque :

     Les VM doivent provenir du même catalogue.

Mettre à jour les propriétés des VM individuelles

Vous pouvez mettre à jour les propriétés des VM individuelles dans un catalogue de machines MCS persistant à l’aide de la commande PowerShell Set-ProvVM. Cependant, les mises à jour ne sont pas appliquées immédiatement. Vous devez définir la fenêtre de temps à l’aide de la commande PowerShell Set-ProvVMUpdateTimeWindow pour que les mises à jour soient appliquées.

Cette implémentation vous aide à gérer efficacement les VM individuelles sans mettre à jour l’intégralité du catalogue de machines. Actuellement, cette fonctionnalité n’est applicable qu’à l’environnement Azure.

Actuellement, les propriétés que vous pouvez mettre à jour sont :

• CustomProperties
• ServiceOffering
• MachineProfile

À l’aide de cette fonctionnalité, vous pouvez :

• Mettre à jour les propriétés d’une VM
• Conserver les propriétés mises à jour sur une VM après la mise à jour du catalogue de machines
• Annuler les mises à jour de configuration appliquées à une VM

Avant de mettre à jour les propriétés d’une VM :

1. Ouvrez une fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

3. Vérifiez la configuration du catalogue de machines existant. Par exemple :

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

4. Vérifiez la configuration de la VM sur laquelle vous souhaitez appliquer les mises à jour. Par exemple :

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

Mettre à jour les propriétés d’une VM

Procédez comme suit pour mettre à jour les propriétés d’une VM :

1. Arrêtez la VM sur laquelle vous souhaitez appliquer les mises à jour.

2. Mettez à jour les propriétés de la VM. Par exemple, si vous souhaitez mettre à jour la propriété personnalisée du type de stockage (StorageType) de la VM, exécutez la commande suivante :

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

   Vous pouvez mettre à jour simultanément les propriétés de deux VM dans un catalogue de machines. Par exemple :

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

   Remarque :

   Les mises à jour ne sont pas appliquées immédiatement.

3. Obtenez la liste des propriétés à mettre à jour et la version de la configuration. Par exemple :

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

   Vérifiez la valeur de la propriété de Version et les propriétés à mettre à jour (dans ce cas, StorageType).

4. Vérifiez la version de la configuration. Par exemple :

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

   Vérifiez la valeur de la propriété de ProvVMConfigurationVersion. La mise à jour n’est pas encore appliquée. La VM est toujours dans l’ancienne configuration.

5. Demandez une mise à jour planifiée. Par exemple :

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

   Pour plus d’informations sur les mises à jour planifiées, consultez Mettre à jour les machines provisionnées vers l’état actuel du schéma de provisioning.

   Remarque :

   Toute mise à jour de schéma de provisioning en attente est également appliquée.

6. Redémarrez la VM. Par exemple :

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

7. Vérifiez la version de la configuration. Par exemple :

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

   Vérifiez la valeur de la propriété de ProvVMConfigurationVersion. La mise à jour est maintenant appliquée. La VM dispose désormais de la nouvelle configuration.

8. Pour appliquer d’autres mises à jour de configuration sur la VM, éteignez la VM et répétez les étapes.

Conserver les propriétés mises à jour sur une VM après la mise à jour du catalogue de machines

Procédez comme suit pour conserver les propriétés mises à jour sur une VM :

1. Éteignez la VM sur laquelle vous souhaitez appliquer les mises à jour.

2. Mettez à jour le catalogue de machines. Par exemple, si vous souhaitez modifier la taille de la VM (ServiceOffering) et le type de stockage (StorageType), exécutez la commande suivante :

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

3. Obtenez les détails de configuration du catalogue de machines. Par exemple :

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

   Le ProvisioningSchemeVersion est maintenant incrémenté de un. La taille de la VM et le type de stockage sont également mis à jour.

4. Mettez à jour les propriétés de la VM. Par exemple, fournissez un profil de machine à 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-->
   

   Remarque :

   L’entrée du profil de machine spécifie une balise et une taille de VM différente (ServiceOffering).

5. Obtenez la liste des propriétés que la VM aura après la fusion des mises à jour de configuration sur la VM avec les mises à jour du catalogue de machines. Par exemple :

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

   Remarque :

   Toutes les mises à jour sur la VM remplaceront les mises à jour effectuées sur le catalogue de machines.

6. Demandez une mise à jour planifiée pour la VM. Par exemple :

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

7. Redémarrez la VM. Par exemple :

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

   La VM conserve sa taille de VM mise à jour, telle que dérivée du profil de machine. Les valeurs de balise spécifiées dans le profil de machine sont également appliquées à la VM. Cependant, le type de stockage est dérivé du dernier schéma de provisionnement.

8. Obtenez la version de configuration de la VM. Par exemple :

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

   Le ProvisioningSchemeVersion et le ProvVMConfigurationVersion affichent maintenant la dernière version.

Annuler les mises à jour de configuration appliquées à une VM

1. Après avoir appliqué les mises à jour à une VM, éteignez la VM.

2. Exécutez la commande suivante pour supprimer les mises à jour appliquées sur la VM. Par exemple :

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

3. Demander une mise à jour planifiée pour la VM. Par exemple :

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

4. Redémarrer la VM. Par exemple :

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

5. Vérifier la version de configuration de la VM. Par exemple :

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

   La valeur ProvVMConfigurationVersion est maintenant la version de configuration du catalogue de machines.

Modifier le chiffrement de disque

Vous pouvez modifier le chiffrement de disque dans les environnements de virtualisation Azure et effectuer les opérations suivantes :

• Créez un catalogue de machines MCS avec un ensemble de chiffrement de disque (DES) différent du DES de l’image principale à l’aide de la commande New-ProvScheme. Par exemple :

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

• Modifiez le type de chiffrement de disque d’une clé DES à une autre clé DES d’un catalogue de machines MCS existant et des VM existantes à l’aide des commandes Set-ProvScheme et Set-ProvVMUpdateTimeWindow. Après avoir redémarré les VM, vous pouvez voir la clé DES mise à jour. Par exemple :

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

• Mettez à jour un catalogue de machines MCS et une VM qui n’étaient pas précédemment activés pour CMEK afin d’avoir un chiffrement de clé géré par le client (CMEK) (DES), un chiffrement de disque au niveau de l’hôte ou un double chiffrement à l’aide des commandes Set-ProvScheme et Set-ProvVMUpdateTimeWindow. Pour plus d’informations sur les différents types de chiffrement, consultez Chiffrement côté serveur Azure, Chiffrement de disque Azure au niveau de l’hôte et Double chiffrement sur disque géré.

• Mettez à jour un catalogue de machines MCS et des VM existants pour qu’ils ne soient pas chiffrés, alors qu’ils l’étaient auparavant, à l’aide des commandes Set-ProvScheme et Set-ProvVMUpdateTimeWindow. Par exemple :

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

• Activez le chiffrement de disque avec un point de terminaison privé (un catalogue de machines MCS qui a utilisé une connexion d’hôte activée avec ProxyHypervisorTrafficThroughConnector). Pour plus d’informations sur l’activation du chiffrement de disque avec des points de terminaison privés, consultez Activer le chiffrement de disque avec un point de terminaison privé.

Activer le chiffrement de disque avec un point de terminaison privé

Conformément à la limitation d’Azure, vous ne pouvez actuellement pas avoir de chiffrement côté serveur avec des clés gérées par le client pour les points de terminaison privés. Cependant, vous pouvez mettre à jour un catalogue de machines MCS existant et des VM avec des points de terminaison privés pour qu’ils soient chiffrés avec la clé DES.

Mettre à jour un catalogue de machines existant avec des points de terminaison privés

Les étapes détaillées pour mettre à jour un catalogue de machines existant avec des points de terminaison privés sont les suivantes :

1. Créez un catalogue sans chiffrement de disque via ProxyHypervisorTrafficThroughConnector.

2. Exécutez Set-ProvScheme pour mettre à jour le catalogue avec DiskEncryptionSetId.

   Remarque :

   DiskEcryptionSetId peut être configuré via CustomProperties ou MachineProfile. Lorsqu’il est défini à la fois dans CustomProperties et MachineProfile, les propriétés définies dans CustomProperties sont appliquées.

   Exemple lors de l’utilisation de 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-->
   

   Exemple lors de l’utilisation de MachineProfile : utilisez une machine virtuelle dont le chiffrement de disque est activé ou une spécification de modèle avec des paramètres de chiffrement de disque :

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

   Vous pouvez également mettre à jour un profil de machine à l’aide de Web Studio.

3. Exécutez Set-ProvVMUpdateTimeWindow pour mettre à jour les machines virtuelles de catalogue existantes. Par exemple :

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

4. Après avoir redémarré les machines virtuelles, vous pouvez voir le chiffrement de disque mis à jour sur les disques de la machine virtuelle dans le portail Azure.

5. Exécutez Set-ProvScheme pour désactiver le chiffrement de disque avant d’ajouter de nouvelles machines virtuelles de catalogue.

   Remarque :

   Cette étape est requise car vous mettez à jour un catalogue de points de terminaison privés. Si vous ne suivez pas cette étape, vous obtiendrez des erreurs en essayant d’ajouter de nouvelles machines virtuelles au catalogue.

   Par exemple :

   $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. Ajoutez de nouvelles machines virtuelles au catalogue.

Mettre à jour les machines virtuelles de catalogue individuelles

Les étapes détaillées pour mettre à jour les machines virtuelles de catalogue individuelles sont les suivantes :

1. Créez un catalogue sans chiffrement de disque via ProxyHypervisorTrafficThroughConnector.

2. Exécutez Set-ProvVM pour mettre à jour la machine virtuelle du catalogue avec DiskEncryptionSetId.

   Remarque :

   Le DiskEcryptionSetId peut être configuré via CustomProperties ou MachineProfile.

   Exemple lors de l’utilisation de 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-->
   

   Exemple lors de l’utilisation de MachineProfile :

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

3. Exécutez Set-ProvVMUpdateTimeWindow pour mettre à jour les machines virtuelles de catalogue existantes. Par exemple :

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

4. Après avoir redémarré les machines virtuelles, vous pouvez voir le chiffrement de disque mis à jour sur les disques des machines virtuelles dans le portail Azure.
5. Ajoutez de nouvelles machines virtuelles au catalogue.

Récupérer des informations pour les machines virtuelles Azure, les instantanés, le disque du système d’exploitation et la définition d’image de galerie

Vous pouvez afficher des informations pour une machine virtuelle Azure, y compris le disque et le type de système d’exploitation, l’instantané et la définition d’image de galerie. Ces informations sont affichées pour les ressources sur l’image principale lorsqu’un catalogue de machines est attribué. Utilisez cette fonctionnalité pour afficher et sélectionner une image Linux ou Windows. Une propriété PowerShell, TemplateIsWindowsTemplate, a été ajoutée au paramètre AdditionDatafield. Ce champ contient des informations spécifiques à Azure : type de machine virtuelle, disque du système d’exploitation, informations d’image de galerie et informations de type de système d’exploitation. La définition de TemplateIsWindowsTemplate sur True indique que le type de système d’exploitation est Windows ; la définition de TemplateIsWindowsTemplate sur False indique que le type de système d’exploitation est Linux.

Conseil :

Les informations affichées par la propriété PowerShell TemplateIsWindowsTemplate sont dérivées de l’API Azure. Parfois, ce champ peut être vide. Par exemple, un instantané d’un disque de données ne contient pas le champ TemplateIsWindowsTemplate car le type de système d’exploitation ne peut pas être récupéré à partir d’un instantané.

Par exemple, définissez le paramètre AdditionData de la machine virtuelle Azure sur True pour le type de système d’exploitation Windows à l’aide de 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-->

Identifier les ressources créées par MCS

Voici les balises que MCS ajoute aux ressources. Les balises du tableau sont représentées sous la forme “clé”:”valeur”.

Remarque :

Une VM n’est pas visible dans l’inventaire Citrix si une balise CitrixResource est ajoutée pour l’identifier comme une ressource créée par MCS. Vous pouvez supprimer ou renommer la balise pour la rendre visible.

Supprimer les balises

Lorsque vous créez un catalogue ou une VM, des balises sont créées sur les ressources suivantes :

• Groupe de ressources
• Machine virtuelle
• Disque OS
• Disque d’identité
• Interface réseau
• Compte de stockage

Vous pouvez supprimer des machines virtuelles et des catalogues de machines de la base de données Citrix et supprimer des balises. Vous pouvez utiliser :

• Remove-ProvVM avec le paramètre ForgetVM pour supprimer des machines virtuelles et des balises d’une seule machine virtuelle ou d’une liste de machines virtuelles d’un catalogue de machines.
• Remove-ProvScheme avec le paramètre ForgetVM pour supprimer un catalogue de machines de la base de données Citrix et des balises d’un catalogue de machines entier.

Cette fonctionnalité s’applique uniquement aux machines virtuelles persistantes.

Pour ce faire :

1. Ouvrez une fenêtre PowerShell.
2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

3. Exécutez Remove-ProvVM pour supprimer les machines virtuelles de la base de données Citrix et les balises des machines virtuelles. Par exemple :

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

4. Exécutez Remove-ProvScheme pour supprimer le catalogue de machines de la base de données Citrix et les balises des catalogues de machines. Par exemple :

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

   Remarque :

   Après avoir utilisé le paramètre ForgetVM dans Remove-ProvScheme, MCS supprime tous les instantanés, y compris l’instantané du disque de base, si le schéma de provisionnement est présent dans votre propre groupe de ressources (BYORG) ou dans un groupe de ressources géré par Citrix.

Plus d’informations

• Créer et gérer des connexions et des ressources
• Connexion à Microsoft Azure
• Créer des catalogues de machines
• Créer un catalogue Microsoft Azure
• Gérer les catalogues de machines