Créer un catalogue AWS

May 31, 2026

Contributeur:

(/fr-fr/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-create.html) décrit les assistants qui créent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements de virtualisation AWS.

Remarque :

Avant de créer un catalogue AWS, vous devez terminer la création d’une connexion à AWS. Consultez (/fr-fr/citrix-virtual-apps-desktops/2503/install-configure/connections/connection-aws.html).

Limitation

À partir de Citrix Virtual Apps and Desktops™ 2203 LTSR et versions ultérieures, le plug-in MCS AWS effectue un appel d’API AWS DescribeInstanceTypes et si celui-ci réussit, MCS utilise le nom d’inventaire créé à partir de la réponse de l’API.

Par conséquent, lorsque vous effectuez une mise à niveau de Citrix Virtual Apps and Desktops 1912 vers la version 2203 ou ultérieure, désactivez l’autorisation DefineInstanceType sur AWS, puis mettez à jour le catalogue existant à l’aide de la commande Set-ProvScheme pour qu’il corresponde au schéma de nommage AWS. Ensuite, ajoutez les autorisations DescribeInstanceType une fois la mise à jour du catalogue terminée et l’offre de service correspond au schéma de nommage AWS.

Paramètre réseau pendant la préparation de l’image

Pendant la préparation de l’image, une machine virtuelle (VM) de préparation est créée à partir de la VM d’origine. Cette VM de préparation est déconnectée du réseau. Pour déconnecter le réseau de la VM de préparation, un groupe de sécurité réseau est créé pour refuser tout trafic entrant et sortant. Ce groupe de sécurité réseau persiste et est réutilisé. Le nom du groupe de sécurité réseau est Citrix.XenDesktop.IsolationGroup-GUID, où GUID est généré aléatoirement.

Configurer la location AWS

AWS propose les options de location suivantes :

Location partagée (type par défaut) : plusieurs instances Amazon EC2 de différents clients peuvent résider sur le même matériel physique.
Location dédiée : vos instances EC2 s’exécutent uniquement sur du matériel avec d’autres instances que vous avez déployées. D’autres clients n’utilisent pas le même matériel.

Vous pouvez utiliser MCS pour provisionner des hôtes dédiés AWS à l’aide de PowerShell.

Configurer la location d’hôtes dédiés AWS à l’aide de PowerShell

Vous pouvez créer un catalogue de machines avec une location d’hôte définie via PowerShell.

Un [EC2] hôte dédié Amazon est un serveur physique avec une capacité d’instance [EC2] entièrement dédiée, vous permettant d’utiliser les licences logicielles existantes par socket ou par machine virtuelle.

Les hôtes dédiés ont une utilisation prédéfinie basée sur le type d’instance. Par exemple, un seul hôte dédié alloué de type d’instance C4 Large est limité à l’exécution de 16 instances. Consultez le site AWS pour plus d’informations.

Les exigences pour le provisionnement sur les hôtes AWS incluent :

Une image BYOL (apportez votre propre licence) importée (AMI). Avec les hôtes dédiés, utilisez et gérez vos licences existantes.
Une allocation d’hôtes dédiés avec une utilisation suffisante pour satisfaire les demandes de provisionnement.
activer auto-placement.

Pour provisionner sur un hôte dédié dans AWS à l’aide de PowerShell, utilisez l’applet de commande New-ProvScheme avec le paramètre TenancyType défini sur Host.

Reportez-vous à la documentation pour développeurs Citrix pour plus d’informations.

Capturer les propriétés de la machine à partir des profils de machine

Lors de la création d’un catalogue pour provisionner des machines AWS à l’aide de MCS, vous pouvez utiliser un profil de machine pour prédéfinir certains paramètres de propriété de machine.

Pour ce faire, suivez ces étapes :

Stockez les profils de machine dans la même zone de disponibilité que les ressources où vous créez ce catalogue.
Sur la page Modèle de machine de l’assistant de création de catalogue, sélectionnez Utiliser un profil de machine. Les profils de machine qui se trouvent dans la même zone disponible que les ressources que vous avez sélectionnées sont affichés.
Sélectionnez un profil de machine si nécessaire.

Baliser les ressources opérationnelles AWS

Lors de la création d’un catalogue pour provisionner des machines dans AWS à l’aide de MCS, vous pouvez contrôler si le rôle IAM et les propriétés de balise sont appliqués à ces machines. Vous pouvez également contrôler si les balises de machine sont appliquées aux ressources opérationnelles.

Une Amazon Machine Image (AMI) représente un type d’appliance virtuelle utilisée pour créer une machine virtuelle dans l’environnement Amazon Cloud, communément appelé EC2. Vous utilisez une AMI pour déployer des services qui utilisent l’environnement EC2. Lorsque vous créez un catalogue pour provisionner des machines à l’aide de MCS pour AWS, vous sélectionnez l’AMI pour servir d’image principale pour ce catalogue.

Important :

La création de catalogues à l’aide d’un profil de machine et d’un modèle de lancement est requise pour l’utilisation du balisage des ressources opérationnelles.

Pour créer un catalogue AWS, vous devez d’abord créer une AMI pour l’instance que vous souhaitez utiliser comme image principale. MCS lit les balises de cette instance et les intègre dans le modèle de lancement. Les balises du modèle de lancement sont ensuite appliquées à toutes les ressources Citrix® créées dans votre environnement AWS, y compris :

Machines virtuelles
Disques de VM
Interfaces réseau de VM
Buckets S3
Objets S3
Modèles de lancement
AMI

Baliser les ressources opérationnelles à l’aide de Web Studio

Lors de la création d’un catalogue pour provisionner des machines dans AWS à l’aide de MCS, vous pouvez contrôler si les balises de machine sont appliquées aux ressources opérationnelles en sélectionnant l’option Appliquer les balises de machine aux ressources opérationnelles sur la page Modèle de machine.

Cette option contrôle si des balises de machine doivent être appliquées à chaque élément créé dans votre environnement AWS qui facilite le provisionnement des machines. Les ressources opérationnelles sont créées comme sous-produits de la création du catalogue. Elles incluent des ressources temporaires et persistantes, telles que l’instance de VM de préparation et l’AMI.

Baliser les ressources opérationnelles à l’aide de PowerShell

Pour utiliser PowerShell afin de baliser les ressources :

Ouvrez une fenêtre PowerShell à partir de l’hôte DDC.
Exécutez la commande asnp citrix pour charger les modules PowerShell spécifiques à Citrix.

Pour baliser une ressource pour une VM provisionnée, utilisez la propriété personnalisée AwsOperationalResourcesTagging. Exemple :

New-ProvScheme -ProvisioningSchemeName test
-CustomProperties “AwsOperationalResourcesTagging,true”
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
... <Other <standard provscheme parameters>
<!--NeedCopy-->

Copier les balises sur les VM

Vous pouvez copier les balises sur les cartes réseau et les disques (disque d’identité, disque de cache en écriture différée et disque de système d’exploitation) spécifiés dans le profil de machine vers les VM nouvellement créées dans un catalogue de machines MCS. Vous pouvez spécifier ces balises dans n’importe quelle source de profil de machine (instance de VM AWS ou version de modèle de lancement AWS). Cette fonctionnalité s’applique aux catalogues de machines et aux VM persistants et non persistants.

Remarque :

Sur la console AWS EC2, vous ne pouvez pas voir les valeurs Tag Network Interfaces sous les Launch Template Version Resource Tags. Cependant, vous pouvez exécuter la commande PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 pour voir les spécifications de balise.

Si une source de profil de machine (VM ou version de modèle de lancement) possède deux interfaces réseau (eni-1 et eni-2), et que eni-1 a la balise t1 et eni-2 a la balise t2, alors la VM obtient les balises des deux interfaces réseau.

Créer un catalogue à l’aide d’un profil de machine

Vous pouvez utiliser un profil de machine pour capturer les propriétés matérielles d’une instance EC2 (VM) ou d’une version de modèle de lancement et les appliquer aux machines provisionnées. Les propriétés capturées peuvent inclure, par exemple, les propriétés de volume EBS, le type d’instance, l’optimisation EBS, les options de CPU, le type de location, la capacité d’hibernation et d’autres configurations AWS prises en charge.

Vous pouvez utiliser une instance AWS EC2 (VM) ou une version de modèle de lancement AWS comme entrée de profil de machine.

Remarque :

Les propriétés de volume EBS sont dérivées uniquement d’un profil de machine.

MCS provisionne des VM avec des disques d’identité de type de volume GP3. Comme le type de volume GP3 est l’option la moins chère proposée par AWS, cette fonctionnalité minimise les coûts. L’implémentation s’applique uniquement aux VM ajoutées à un nouveau catalogue et aux nouvelles VM ajoutées à un catalogue existant. Les VM existantes créées avant cette fonctionnalité continueront d’avoir des disques d’identité de type de volume GP2, à moins que le disque d’identité ne soit réinitialisé.

Considérations importantes

Les considérations importantes lors de la création d’un catalogue de machines MCS :

Si vous ajoutez des paramètres de propriété matérielle de machine dans les commandes New-ProvScheme et Set-ProvScheme, alors les valeurs fournies dans les paramètres écrasent les valeurs du profil de machine.
Si vous définissez AwsCaptureInstanceProperties comme true et ne définissez pas la propriété MachineProfile, alors seuls les rôles IAM et les balises sont capturés.
Vous ne pouvez pas définir AwsCaptureInstanceProperties et MachineProfile en même temps.

Remarque :

Le AwsCaptureInstanceProperties est obsolète.
Si un profil de machine n’est pas fourni, vous devez explicitement fournir les valeurs des propriétés suivantes :
- Groupe de sécurité
- ENI ou réseau virtuel
Vous ne pouvez activer AwsOperationalResourcesTagging que si vous activez AwsCaptureInstanceProperties ou spécifiez un profil de machine.

Les considérations importantes après la création d’un catalogue de machines MCS :

Vous ne pouvez pas modifier un catalogue basé sur un profil de machine en un catalogue non basé sur un profil de machine.

Créer un catalogue de machines à l’aide d’un profil de machine

Pour créer un catalogue de machines à l’aide d’un profil de machine :

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

Créez un pool d’identités s’il n’est pas déjà créé. Par exemple,

New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
<!--NeedCopy-->

Exécutez la commande New-ProvScheme. Par exemple :

New-ProvScheme -ProvisioningSchemeName demet-test-1
-HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
-IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
-CleanOnBoot
-MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
-MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
<!--NeedCopy-->

Terminez la création du catalogue. Pour plus d’informations, consultez le SDK Citrix PowerShell.

Mettre à jour le profil de machine

Pour mettre à jour le profil de machine sur un catalogue initialement provisionné avec un profil de machine, procédez comme suit. Vous pouvez également modifier le type de location et la capacité d’hibernation de la source du profil de machine lors de la modification d’un catalogue de machines MCS.

Exécutez la commande Set-ProvScheme. Par exemple,

Set-ProvScheme `
-ProvisioningSchemeUid "<ID" `
-MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
<!--NeedCopy-->

Créer un catalogue avec une version de modèle de lancement

Vous pouvez créer un catalogue de machines MCS avec une version de modèle de lancement comme entrée de profil de machine. Vous pouvez également mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement et d’une version de modèle de lancement vers une VM.

Sur la console AWS EC2, vous pouvez fournir les informations de configuration d’instance d’un modèle de lancement ainsi que le numéro de version. Lorsque vous spécifiez la version du modèle de lancement comme entrée de profil de machine lors de la création ou de la mise à jour d’un catalogue de machines, les propriétés de cette version du modèle de lancement sont copiées dans les VM VDA provisionnées.

Les propriétés suivantes peuvent être fournies à l’aide de l’entrée du profil de machine ou explicitement en tant que paramètres dans les commandes New-ProvScheme ou Set-ProvScheme. Si elles sont fournies dans les commandes New-ProvScheme ou Set-ProvScheme, elles prévalent sur les valeurs du profil de machine de ces propriétés.

Offre de service
Réseaux
Groupes de sécurité
Type de location

Remarque :

Si l’offre de service n’est pas fournie dans le modèle de lancement du profil de machine ou en tant que paramètre dans la commande New-ProvScheme, une erreur appropriée s’affiche.

Pour créer un catalogue en utilisant la version du modèle de lancement comme entrée de profil de machine :

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

Obtenez la liste des versions d’un modèle de lancement. Par exemple :

XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
<!--NeedCopy-->

Créez un pool d’identités s’il n’est pas déjà créé. Par exemple :

New-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numeric `
-Domain "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

Créez un schéma de provisionnement avec une version de modèle de lancement comme entrée de profil de machine. Par exemple :

New-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
-IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

Enregistrez le schéma de provisionnement en tant que catalogue de courtier. Par exemple :

New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->

Terminez la création du catalogue. Pour plus d’informations, consultez le SDK PowerShell de Citrix

Vous pouvez également mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement et d’une version de modèle de lancement vers une VM. Par exemple :

Pour mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement :

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

Pour mettre à jour l’entrée d’un catalogue de profils de machine d’une version de modèle de lancement vers une VM :

 Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
 <!--NeedCopy-->

Catalogue compatible MCSIO

L’optimisation du stockage MCS (MCSIO) améliore les performances de la VM en mettant en cache les opérations de disque soit en mémoire, soit sur un petit disque haute vitesse. Vous pouvez créer un catalogue non persistant compatible MCSIO à l’aide de commandes PowerShell. Pour créer un tel catalogue, vous devez installer le pilote MCSIO lors de l’installation ou de la mise à niveau du VDA pendant la préparation de l’instance AMI. Par défaut, ce pilote n’est pas installé.

Une fois qu’une AMI MCSIO est préparée, vous pouvez créer un catalogue non persistant compatible MCSIO.

Créer un catalogue compatible MCSIO

Les quatre paramètres ajoutés à la commande PowerShell New-ProvScheme sont :

UseWriteBackCache : Active la mise en cache (cache en écriture différée) pour le schéma de provisionnement donné
WriteBackCacheDiskSize : Spécifie la taille en Go du disque temporaire utilisé pour la mise en cache
WriteBackCacheMemorySize : Spécifie la quantité de mémoire en Mo à utiliser pour la mise en cache. Ce paramètre est facultatif.
WriteBackCacheDriverLetter : Spécifie la lettre de lecteur à attribuer au disque de stockage du cache. Ce paramètre est facultatif.

Remarque :

La valeur de WriteBackCacheDiskSize doit être supérieure à zéro car au moins 1 Go de stockage sur disque cache est requis. La taille du disque cache ne doit pas être supérieure à la taille du disque du système d’exploitation.

La valeur de WriteBackCacheMemorySize doit être non nulle et inférieure à la taille de la mémoire du catalogue de machines.

Les propriétés personnalisées qui affectent MCSIO sont :

WBCDiskStorageType : Définit le type de volume utilisé pour le disque temporaire dans AWS. Ce paramètre prend un argument de chaîne au format volume-type[:iops][:throughput]. Voici les types de volume :
- gp2 : N’utilisez pas les paramètres iops et throughput pour ce type de volume
- gp3 : Utilisez les paramètres iops et throughput pour ce type de volume
- io1 : Utilisez uniquement le paramètre iops pour ce type de volume
- io2 : Utilisez uniquement le paramètre iops pour ce type de volume
Le type de volume par défaut est gp2.
PersistWBC : Contrôle si le disque de cache doit être conservé ou supprimé chaque fois que l’instance AWS est mise hors tension. S’il est défini sur true, le disque de cache est conservé. S’il est défini sur false (par défaut), le disque de cache n’est créé et conservé que lorsque l’instance AMI est sous tension.
PersistOSDisk : Contrôle si le disque du système d’exploitation doit être conservé ou supprimé chaque fois que l’instance AWS est mise hors tension. S’il est défini sur true, le disque du système d’exploitation est conservé. S’il est défini sur false (par défaut), le disque du système d’exploitation n’est créé et conservé que lorsque l’instance AMI est sous tension.

Effectuez les étapes suivantes dans la fenêtre PowerShell pour créer un catalogue non persistant activé pour MCSIO :

Ouvrez la fenêtre PowerShell.
Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.
Créez un catalogue de courtiers et un pool d’identités.

Créez le schéma de provisionnement. Par exemple :

$HostingUnitUid = '0xxxx1d9-bbfc-xxxf-bxxb-exxxxxe008b2'
$MasterImageVM = 'XDHyp:\HostingUnits\ctx-test\aws-apollo-non-persistent-multi-mcsio-vda-win2022 (ami-0bf1810488acbxxxb).template'
$NetworkMap = @{ 'NetworkPath' = 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\10.0.128.0`/17 (vpc-0fa6e41d72507fxxx).network' }
$SecurityGroup = $( 'XDHyp:\HostingUnits\ctx-test\us-east-1a.availabilityzone\private.securitygroup' )
$ServiceOffering = 'XDHyp:\HostingUnits\ctx-test\T3 Medium Instance.serviceoffering'
$CustomProperties = 'WBCDiskStorageType,gp3:6000:250;PersistWBC,false'


$provScheme = New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
-IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
- MasterImageVM $MasterImageVM `
-NetworkMap $NetworkMap `
-ServiceOffering $ServiceOffering `
-SecurityGroup $SecurityGroup `
-CustomProperties $CustomProperties `
-UseWriteBackCache -WriteBackCacheDiskSize 16 -WriteBackCacheMemorySize 256
<!--NeedCopy-->

Ajoutez des machines virtuelles au catalogue.

Améliorer les performances de démarrage avec MCSIO

Vous pouvez améliorer les performances de démarrage des machines virtuelles si vous activez MCSIO et définissez les propriétés personnalisées PersistWBC et PersistOSDisk sur true. Avec un tel paramètre, les machines virtuelles peuvent démarrer plus rapidement car elles n’ont pas besoin d’initialiser un nouveau disque de cache ou de recréer un disque racine à partir de leur modèle.

Chiffrer les disques OS, ID et WBC

Vous pouvez créer un catalogue de VM persistant et non persistant avec des clés AWS KMS (clé gérée par le client et clé gérée par AWS) qui peuvent être utilisées pour chiffrer le disque du système d’exploitation (OS), le disque d’identité (ID) et le disque de cache en écriture différée (WBC).

Les clés gérées par AWS sont automatiquement renouvelées chaque année.
La rotation automatique des clés gérées par le client est facultative et peut être gérée manuellement.

Vous pouvez consulter les documents AWS suivants pour plus d’informations sur les clés KMS :

Pour le chiffrement des disques OS, ID et WBC, configurez l’une des options suivantes :

Utilisez une image principale chiffrée (par exemple, une AMI créée à partir d’une instance ou d’un instantané qui contient un volume racine EBS chiffré avec une clé KMS)
Utilisez une source de profil de machine (VM ou modèle de lancement) qui contient un volume racine EBS chiffré.

Limitations

Tenez compte des limitations suivantes :

MCS ne prend actuellement en charge qu’un seul disque sur l’AMI de l’image principale.
Vous ne pouvez pas chiffrer directement les volumes ou instantanés EBS non chiffrés existants, ni modifier la clé KMS d’un volume chiffré existant. Pour ce faire, vous devez :
1. Créez un nouvel instantané de ce volume.
2. Créez un nouveau volume à partir de cet instantané
3. Chiffrez le nouveau volume.

Consultez les documents AWS suivants :

Chiffrer les ressources non chiffrées
Limitations du chiffrement automatique ou par défaut des volumes EBS : Chiffrer automatiquement les volumes Amazon EBS existants et nouveaux.

Créer un catalogue avec chiffrement de disque

Vous pouvez créer un catalogue de machines MCS avec chiffrement de disque en utilisant :

Image principale
Profil de machine

Considérations lors de l’utilisation de l’entrée de profil de machine :

La clé KMS de l’entrée du profil de machine prévaut sur la clé KMS de l’image principale.
Si aucune entrée de profil de machine n’est fournie, la clé KMS de l’AMI de l’image principale est utilisée pour chiffrer les disques des VM du catalogue.
Si le profil de machine contient des mappages de périphériques de bloc, les périphériques de bloc présents dans le modèle d’image principale (AMI) et le profil de machine doivent correspondre. Par exemple, si l’AMI a un périphérique défini sur /dev/sda1, le profil de machine doit également avoir un périphérique défini sur /dev/sda1.
S’il n’y a pas de clé dans la source du profil de machine et que l’image principale n’est pas chiffrée, les disques des VM du catalogue ne sont pas chiffrés.
Lorsque l’image principale est chiffrée, une VM source de profil de machine ou un modèle de lancement doit avoir un volume racine chiffré pour être considéré comme une entrée valide.

Modifier un catalogue existant

Vous pouvez modifier un catalogue existant à l’aide de la commande PowerShell Set-ProvScheme pour avoir :

Une entrée de profil de machine avec un volume contenant une nouvelle clé KMS.
Une AMI de modèle d’image principale chiffrée avec une nouvelle clé KMS.

Considérations importantes :

Les volumes des nouvelles machines virtuelles ajoutées au catalogue sont chiffrés avec la nouvelle clé KMS.
Pour mettre à jour les paramètres de chiffrement lorsqu’il existe un profil de machine existant, exécutez Set-ProvScheme avec un nouveau profil de machine.
Vous ne pouvez pas modifier un catalogue existant pour passer de volumes chiffrés à des volumes non chiffrés. Vous ne pouvez pas effectuer une mise à jour d’image d’une AMI principale chiffrée vers une AMI principale non chiffrée.

Activer NitroTPM et le démarrage sécurisé UEFI pour les instances de machines virtuelles

Lors de la création d’un catalogue, vous pouvez désormais sélectionner une image principale (AMI) avec NitroTPM et/ou le démarrage sécurisé UEFI activés. En conséquence, les machines virtuelles provisionnées dans le catalogue sont également activées avec NitroTPM et/ou le démarrage sécurisé UEFI. Cette implémentation garantit que les machines virtuelles sont sécurisées et fiables. Pour plus d’informations sur NitroTPM et le démarrage sécurisé UEFI, consultez la documentation Amazon.

Limitations

Vous pouvez utiliser NitroTPM et le démarrage sécurisé actuellement dans toutes les régions AWS (y compris les régions AWS GovCloud (US)), à l’exception de la Chine.
Vous ne pouvez pas activer NitroTPM et le démarrage sécurisé UEFI sur les catalogues existants. Si vous souhaitez un catalogue avec NitroTPM et le démarrage sécurisé UEFI activés, créez un nouveau catalogue.

Étapes clés

Configurez votre environnement AWS.
Créer une connexion à AWS.
Créer une image principale (AMI) activée avec NitroTPM et/ou le démarrage sécurisé UEFI.
Créez un catalogue de machines en sélectionnant l’image principale avec NitroTPM et le démarrage sécurisé UEFI activés dans le menu de création de catalogue de Web Studio ou lors de la création d’un schéma de provisionnement à l’aide de commandes PowerShell.

Les machines virtuelles ajoutées au catalogue créé ont NitroTPM et le démarrage sécurisé UEFI activés.

Créer une AMI qui prend en charge NitroTPM et le démarrage sécurisé UEFI

Vous pouvez créer une AMI à partir d’une machine virtuelle qui a NitroTPM et/ou le démarrage sécurisé UEFI activés.
1. Créez l’instance à partir des images de la place de marché AWS. Par exemple, recherchez TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
2. Téléchargez un VDA à session unique ou multi-session.
3. Créez une AMI à partir de cette machine virtuelle.
Utilisez la commande register-image :
```
--boot-mode (string)
--tpm-support (string)

```
Pour plus d’informations, consultez register-image.

Consultez les documents AWS suivants :

Vous pouvez ouvrir une fenêtre PowerShell à partir de l’hôte du Delivery Controller™ pour vérifier si un élément spécifique :

l’offre de service prend en charge NitroTPM ou le démarrage sécurisé UEFI

 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.BootMode
 (Get-Item -Path “XDHyp:\HostingUnits\aws\T3 Medium Instance.serviceoffering”).AdditionalData.NitroTpmSupportVersions
 <!--NeedCopy-->

le modèle prend en charge NitroTPM ou le démarrage sécurisé UEFI

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.BootMode

 (Get-HypInventoryItem -LiteralPath “XDHyp:\HostingUnits\aws” -ResourceType “template -Id “ID”).AdditionalData.TpmSupport
 <!--NeedCopy-->

Mettre à jour l’offre de service d’un catalogue existant

Vous pouvez modifier l’offre de service d’un catalogue existant à l’aide de Set-ProvScheme. La modification s’applique aux nouvelles machines virtuelles ajoutées. Cependant, des erreurs se produisent dans les scénarios suivants :

Mode de démarrage des AMI	L’AMI prend-elle en charge Nitro TPM ?	L’offre de service prend-elle en charge NitroTPM et le démarrage sécurisé UEFI ?
UEFI	Non	Non
BIOS hérité	Oui	Non
UEFI	Oui	Non
UEFI préféré	Oui	Non

Filtrer les instances de VM

Une instance AWS EC2 que vous utilisez comme VM de profil de machine doit être compatible pour que le catalogue de machines puisse être créé et fonctionner correctement. Pour répertorier les instances AWS EC2 pouvant être utilisées comme VM d’entrée de profil de machine, vous pouvez utiliser la commande Get-HypInventoryItem. La commande peut paginer et filtrer l’inventaire des VM disponibles sur une unité d’hébergement.

Pagination :

Get-HypInventoryItem prend en charge deux modes de pagination :

Le mode de pagination utilise les paramètres -MaxRecords et -Skip pour renvoyer des ensembles d’éléments :
- -MaxRecords : La valeur par défaut est 1. Cela contrôle le nombre d’éléments à renvoyer.
- -Skip : La valeur par défaut est 0. Cela contrôle le nombre d’éléments à ignorer depuis le début absolu (ou la fin absolue) de la liste dans l’hyperviseur.
Le mode de défilement utilise les paramètres -MaxRecords, -ForwardDirection et -ContinuationToken pour permettre le défilement des enregistrements :
- -ForwardDirection : La valeur par défaut est True. Ceci est utilisé avec -MaxRecords pour renvoyer soit l’ensemble suivant d’enregistrements correspondants, soit l’ensemble précédent d’enregistrements correspondants.
- -ContinuationToken : Renvoie les éléments immédiatement après (ou avant si ForwardDirection est false) mais sans inclure l’élément donné dans ContinuationToken.

Exemples de pagination :

Pour renvoyer un seul enregistrement du modèle de machine avec le nom le plus bas. Le champ AdditionalData contient le TotalItemsCount et le TotalFilteredItemsCount :
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
 
```

Pour renvoyer 10 enregistrements du modèle de machine avec le nom le plus bas :

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
 <!--NeedCopy-->

Pour renvoyer un tableau d’enregistrements se terminant par le nom le plus élevé :

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
 <!--NeedCopy-->

Pour renvoyer un tableau d’enregistrements commençant par le modèle de machine associé au ContinuationToken donné :

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
 <!--NeedCopy-->

Filtrage :

Les paramètres facultatifs supplémentaires suivants sont pris en charge pour le filtrage. Vous pouvez combiner ces paramètres avec les options de pagination.

-ContainsName "my_name" : Si la chaîne donnée correspond à une partie d’un nom d’AMI, l’AMI est incluse dans le résultat Get. Par exemple :

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
 <!--NeedCopy-->

-Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }' : Si une AMI possède au moins l’une de ces balises, elle est incluse dans le résultat Get. Par exemple :
```
 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 
```
Remarque :

Deux valeurs de balise sont prises en charge. La valeur de balise Non balisé correspond aux éléments qui n’ont pas la balise donnée dans leur liste de balises. La valeur de balise Toutes les valeurs correspond aux éléments qui ont la balise, quelle que soit la valeur de la balise. Sinon, la correspondance n’a lieu que si l’élément possède la balise et que la valeur est égale à celle spécifiée dans le filtre.

-Id "ami-0a2d913927e0352f3" : Si l’AMI correspond à l’ID donné, elle est incluse dans le résultat Get. Par exemple :

 Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
 <!--NeedCopy-->

Filtrage sur le paramètre AdditionalData :

Le paramètre de filtre AdditionalData répertorie les modèles ou les machines virtuelles en fonction de leur capacité, de leur offre de service ou de toute propriété figurant dans AdditionalData. Par exemple :

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

Vous pouvez également ajouter un paramètre -Warn pour indiquer les machines virtuelles incompatibles. Les machines virtuelles sont incluses avec un champ AdditionalData nommé Avertissement. Par exemple :

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Liste des SKU de sauvegarde pour les machines virtuelles

Les clouds publics peuvent parfois manquer de capacité pour un type d’instance EC2 spécifique (SKU principale). Si la configuration de la VM principale n’est pas disponible, la VM ne peut pas démarrer, ce qui entraîne une perte de temps et une interruption des activités. Pour faire face à de tels scénarios, fournissez une liste de types d’instances EC2 de secours (SKU de secours) sur lesquels MCS peut se rabattre en cas de problèmes de capacité.

Utilisez une propriété personnalisée BackupVmConfiguration lors de la création ou de la mise à jour d’un catalogue de machines MCS pour fournir une liste de types d’instances EC2 de secours (Liste des SKU de secours).

Si l’instance EC2 principale échoue, MCS tente de se rabattre sur les types d’instances EC2 de secours dans l’ordre que vous spécifiez. Si MCS ne parvient pas à se rabattre sur l’un des types d’instances EC2 de secours fournis, un message d’erreur s’affiche. Vous pouvez alors essayer de redémarrer l’instance EC2 principale. Si cela échoue, MCS réessaie les types d’instances EC2 de secours.

La liste des SKU de secours peut inclure des instances à la demande.

Cette fonctionnalité s’applique à la fois aux catalogues de machines MCS persistants et non persistants.

Considérations importantes

Vous pouvez fournir plusieurs types d’instances EC2 de secours dans la liste des SKU de secours.
La liste des SKU de secours doit être unique.
Une instance EC2 de secours ne peut pas être la même que l’instance EC2 principale.
Les instances EC2 de secours doivent être des types d’instances AWS valides.
Ne spécifiez pas d’offres de services en double. Exemple : BackupVmConfiguration,t2.small|t3.small|t2.small n’est pas valide.
L’offre de service spécifiée dans la liste doit être compatible avec la configuration du catalogue de machines. Par exemple, si le catalogue utilise l’UEFI et que l’offre de service spécifiée dans la liste de secours ne le prend pas en charge, la création ou la mise à jour du catalogue échoue lors de la vérification préalable.
Vous pouvez modifier la liste des SKU de secours d’un catalogue existant à l’aide de la commande PowerShell Set-ProvScheme. Vous pouvez modifier les VM existantes à l’aide des commandes PowerShell Set-ProvVM et Set-ProvVMUpdateTimeWindow.

Configurer les instances EC2 de secours

Ouvrez une fenêtre PowerShell.
Exécutez asnp citrix\* pour charger les modules PowerShell spécifiques à Citrix.
Créez un catalogue Broker.
Créez un pool d’identités.

Ajoutez une liste d’instances EC2 de sauvegarde à l’aide de la propriété personnalisée BackupVmConfiguration et créez un schéma de provisionnement. Par exemple :

$serviceOffering = "XDHyp:\HostingUnits\$hostingUnitName\T3 Medium Instance.serviceoffering"
$customProperties = "AwsCaptureInstanceProperties,false;AwsOperationalResourcesTagging,false;BackupVmConfiguration,t2.small|t2.large|t3.small|t3.large;"
$createdProvScheme = New-ProvScheme -ProvisioningSchemeName $provisioningSchemeName -HostingUnitName $hostingUnitName -IdentityPoolName $provisioningSchemeName -NetworkMapping $networkMapping -SecurityGroup $securityGroupPath -ServiceOffering $serviceOffering -MasterImageVM $masterImageVm -CustomProperties $customProperties
<!--NeedCopy-->

Mettez à jour le BrokerCatalog avec l’ID unique du schéma de provisionnement.
Créez et ajoutez des machines virtuelles au catalogue.

Étapes suivantes

S’il s’agit du premier catalogue créé, Web Studio vous guide pour créer un groupe de mise à disposition
Pour consulter l’ensemble du processus de configuration, consultez Installer et configurer
Pour gérer les catalogues, consultez Gérer les catalogues de machines et Gérer un catalogue AWS

Plus d’informations

La version officielle de la documentation de ce produit est en anglais. Toute version dans une langue autre que l’anglais est fournie uniquement à titre indicatif et peut inclure du contenu traduit automatiquement. Pour en savoir plus, veuillez consulter la clause de non-responsabilité relative à la traduction automatique sur Cloud Software Group home.

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

Créer un catalogue AWS

May 31, 2026

Contributeur:

May 31, 2026

Contributeur:

Dans cet article

Limitation
Paramètre réseau pendant la préparation de l’image
Configurer la location AWS
Capturer les propriétés de la machine à partir des profils de machine
Baliser les ressources opérationnelles AWS
Copier les balises sur les VM
Créer un catalogue à l’aide d’un profil de machine
Catalogue compatible MCSIO
Chiffrer les disques OS, ID et WBC
Activer NitroTPM et le démarrage sécurisé UEFI pour les instances de machines virtuelles
Filtrer les instances de VM
Liste des SKU de sauvegarde pour les machines virtuelles
Étapes suivantes
Plus d’informations

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