Citrix DaaS

Gérer un catalogue AWS

December 4, 2023

Contributeur:

Gérer les catalogues de machines décrit les assistants qui permettent de gérer un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements de cloud AWS.

Remarque :

Avant de gérer un catalogue AWS, vous devez terminer de créer un catalogue AWS. Voir Créer un catalogue AWS.

Mettre à jour les propriétés des machines virtuelles individuelles

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

Cette implémentation vous permet de gérer efficacement les machines virtuelles individuelles sans mettre à jour l’intégralité du catalogue de machines. Actuellement, cette fonctionnalité s’applique uniquement aux environnements AWS et Azure.

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

ServiceOffering
MachineProfile

Grâce à cette fonctionnalité, vous pouvez :

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

Conditions préalables

Avant de mettre à jour les propriétés d’une machine virtuelle, procédez comme suit :

Ouvrez une fenêtre PowerShell.
Exécutez asnp citrix* pour charger des modules PowerShell spécifiques à Citrix.
Vérifiez la configuration du catalogue de machines existant. Par exemple,
```
Get-ProvScheme -ProvisioningSchemeName ABCCatalog

```
Vérifiez la configuration de la machine virtuelle sur laquelle vous souhaitez appliquer les mises à jour. Par exemple,
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```

Mettre à jour les propriétés d’une machine virtuelle

Éteignez la machine virtuelle sur laquelle vous souhaitez appliquer les mises à jour.

Mettez à jour les propriétés de la machine virtuelle. Par exemple, si vous souhaitez mettre à jour serviceOffering pour la machine virtuelle, exécutez ce qui suit :

Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceofferin"
<!--NeedCopy-->

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

Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceoffering"
Set-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine2 -ServiceOffering "XDHyp:\HostingUnits<HostingUnit><serviceoffering>.serviceoffering"
<!--NeedCopy-->

Remarque :

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

Obtenez la liste des propriétés spécifiées pour la mise à jour ainsi que la version de configuration. Par exemple,
```
Get-ProvVMConfiguration -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Vérifiez la valeur de propriété de Version et les propriétés à mettre à jour (dans ce cas, ServiceOffering).
Vérifiez la version de configuration. Par exemple :
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Vérifiez la valeur de propriété de ProvVMConfigurationVersion. La mise à jour n’est pas encore appliquée. La machine virtuelle est toujours dans l’ancienne configuration.
Demandez une mise à jour planifiée. Par exemple :
```
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName ABCCatalog -StartsNow -DurationInMinutes -1

```
Remarque :

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

Redémarrez la machine virtuelle. Par exemple :

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

Vérifiez la version de configuration. Par exemple :
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Vérifiez la valeur de propriété de ProvVMConfigurationVersion. La mise à jour est maintenant appliquée. La machine virtuelle présente désormais la nouvelle configuration.
Pour appliquer d’autres mises à jour de configuration sur la machine virtuelle, éteignez-la et répétez les étapes.

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

Éteignez la machine virtuelle sur laquelle vous souhaitez appliquer les mises à jour.

Mettez le catalogue de machines à jour. Par exemple, si vous souhaitez modifier le profil de la machine, exécutez ce qui suit :

Set-ProvScheme -ProvisioningSchemeName ABCCatalog
-MachineProfile "XDHyp:\HostingUnits<hosting-unit><launch-template>.launchtemplate<launch-template-version>.launchtemplateversion"
<!--NeedCopy-->

Obtenez les détails de configuration du catalogue de machines. Par exemple :
```
Get-ProvScheme -ProvisioningSchemeName ABCCatalog

```
La ProvisioningSchemeVersion est maintenant incrémentée d’une unité.
Mettez à jour les propriétés de la machine virtuelle. Par exemple, appliquez un profil de machine à la machine virtuelle.
Obtenez la liste des propriétés que la machine virtuelle aura après avoir fusionné les mises à jour de configuration sur la machine virtuelle avec les mises à jour du catalogue de machines. Par exemple :
```
Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName ABCCatalog -VMName machine1

```
Remarque :

Toute mise à jour sur la machine virtuelle remplacera les mises à jour effectuées sur le catalogue de machines.

Demandez une mise à jour planifiée pour la machine virtuelle. Par exemple :

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

Redémarrez la machine virtuelle. Par exemple :
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

```
La machine virtuelle conserve sa propriété serviceoffering mise à jour telle que dérivée de Set-ProvVM sur la machine 1. Toutefois, les valeurs des balises sont dérivées du schéma de provisioning le plus récent.
Obtenez la version de configuration de la machine virtuelle. Par exemple :
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
La ProvisioningSchemeVersion et la ProvVMConfigurationVersion affichent désormais la dernière version.

Annuler les mises à jour de configuration appliquées à une machine virtuelle

Après avoir appliqué les mises à jour à une machine virtuelle, éteignez-la.
Exécutez la commande suivante pour supprimer les mises à jour appliquées à la machine virtuelle. Par exemple :
```
Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName ABCCatalog -VMName machine1

```

Demandez une mise à jour planifiée pour la machine virtuelle. Par exemple :

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

Redémarrez la machine virtuelle. Par exemple :

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

Vérifiez la version de configuration de la machine virtuelle. Par exemple :
```
Get-ProvVM -ProvisioningSchemeName ABCCatalog -VMName machine1

```
La valeur ProvVMConfigurationVersion est désormais la version de configuration du catalogue de machines.

Supprimer les balises

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

Machine virtuelle
Volume du disque racine
Volume du disque d’identité
Carte d’interface réseau
Image du disque racine (AMI)
Modèle de lancement
Capture d’écran de l’AMI ou du disque racine

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

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

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

Pour ce faire :

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

Déverrouillez la machine virtuelle avant de la supprimer. Par exemple :

Unlock-ProvVM -ProvisioningSchemeName "<name>" -VMID "<id"
<!--NeedCopy-->

Exécutez l’une des commandes suivantes pour supprimer des machines virtuelles, un catalogue de machines et des balises de ressources.
- Exécutez Remove-ProvVM avec ForgetVM pour supprimer des machines virtuelles de la base de données Citrix et des balises de machines virtuelles. Par exemple :
```
 Remove-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>" -ForgetVM
 
```
- Exécutez Remove-ProvScheme pour supprimer un catalogue de machines de la base de données Citrix et des ressources d’un catalogue de machines. Par exemple :
```
 Run Remove-ProvScheme -ProvisioningSchemeName "<name>" -ForgetVM
 
```
Vérifiez que la machine virtuelle est supprimée du Delivery Controller, mais pas de l’hyperviseur.
1. Exécutez Get-ProvVM -ProvisioningSchemeName "<name>" -VMName "<name>". Cela ne doit rien retourner.
2. Accédez à la console EC2 d’AWS. Vous devez voir les machines virtuelles, mais les balises sont maintenant supprimées. Les balises des ressources suivantes sont supprimées :
  - Machine virtuelle
  - Volume du disque racine
  - Volume du disque d’identité
  - Carte d’interface réseau
Si vous supprimez le catalogue de machines, vérifiez que le catalogue est supprimé du Delivery Controller.
1. Exécutez Get-ProvScheme -ProvisioningSchemeName "forgetvmdemo". Cela doit renvoyer une erreur.
2. Vérifiez dans la console EC2 d’AWS que les ressources suivantes sont supprimées.
  - Image du disque racine (AMI)
  - Modèle de lancement
  - Capture d’écran de l’AMI ou du disque racine

Identifier les ressources créées par MCS

Voici les balises que MCS ajoute aux ressources de la plateforme AWS. Les balises du tableau sont représentées au format “clé”:”valeur”.

Nom de la ressource	Balise
Disque d’identification	“Name”: “VMName_IdentityDisk”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Image	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Carte d’interface réseau	“Description”: “XD Nic”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Disque OS	“Name”: “VMName_rootDisk”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Machine virtuelle de préparation	“Name”: “Preparation - CatalogName - xxxxxxxxxx”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
Instantané publié	“XdConfig”: “XdProvisioned=true”
	S’il ne s’agit pas d’un instantané pour AMI travailleur de volume, alors “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Modèle	[when AwsCaptureInstanceProperties = true] “XdConfig”: “XdProvisioned=true”
	[when AwsCaptureInstanceProperties = true] “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
VM dans le catalogue	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true] “CitrixResource”: “”
	[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:id”:”lt-xxxx”
	[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:version”: “n”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “”
AMI travailleur de volume	“XdConfig”: “XdProvisioned=true”
Bootstraper travailleur de volume	“Name”: “XenDesktop Temp”
	“XdConfig”: “XdProvisioned=true”
	“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixVolumeWorkerBootstrapper”: “”
Instance travailleur de volume	“Name”: “Citrix.XD.Volumeworker-xxxx-xx-xx-xx-xxxx”
	“XdConfig”: “XdProvisioned=true”

Informations supplémentaires

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Gérer un catalogue AWS

December 4, 2023

Contributeur:

December 4, 2023

Contributeur:

Dans cet article

Mettre à jour les propriétés des machines virtuelles individuelles
Supprimer les balises
Identifier les ressources créées par MCS
Informations supplémentaires

Cela vous a-t-il été utile ?