Documentation produit

Citrix DaaS™

Voir PDF

Créer des catalogues à l’aide d’images préparées dans des instances gérées Amazon WorkSpaces Core

May 4, 2026

Contributeur:

Créez des images préparées et utilisez-les pour créer un catalogue de machines MCS à l’aide de :
Studio
PowerShell

Étapes clés

Créez la définition d’image et la version d’image initiale.
Créez des versions d’image à partir de la version d’image initiale.
Utilisez la version d’image comme image préparée pour créer un catalogue.

Créer une définition d’image et une version d’image initiale à l’aide de Studio

Pour créer une définition d’image et la version d’image initiale, procédez comme suit :

Dans Studio, accédez au nœud Images, puis cliquez sur Créer une définition d’image. Cliquez sur Suivant sur la page Introduction.
Sur la page Définition d’image, spécifiez le type de système d’exploitation et le type de session pour la définition d’image.
Sur la page Image, sélectionnez les Ressources (seules les ressources applicables à la connexion définie sont répertoriées), une image principale à utiliser comme modèle pour la création de la version d’image, et un profil de machine pour la capture des propriétés matérielles. Sélectionnez un profil de machine pour capturer les propriétés matérielles à partir d’une instance de machine virtuelle ou d’une version de modèle de lancement.
Remarque :
- Avant de sélectionner une image, vérifiez que l’image principale a VDA 2311 ou une version ultérieure installée et que le pilote MCSIO est installé sur le VDA.
- Seul le service de métadonnées d’instance (IMDS) V2 est pris en charge, et non IMDS V1. Pour plus d’informations, consultez Fonctionnement de la version 2 du service de métadonnées d’instance.
Sur la page Spécification de la machine, sélectionnez une taille de machine. La taille de machine du profil de machine (sélectionnée sur la page Image) est sélectionnée par défaut.
Sur la page Cartes réseau, sélectionnez ou ajoutez des cartes réseau pour l’image de préparation. Pour chaque carte réseau, sélectionnez un sous-réseau VPC associé.
Sur la page Description de la version, entrez une description pour la version d’image initiale créée.
Sur la page Résumé, vérifiez les détails de la définition d’image et de la version d’image initiale créée. Entrez un nom et une description pour la définition d’image. Cliquez sur Terminer.

Créer des versions d’image à l’aide de Studio

Les versions d’image permettent de gérer différentes itérations ou mises à jour d’une image particulière. Cette fonctionnalité vous permet de conserver plusieurs versions d’une image à des fins différentes.

Pour créer des versions d’image à partir de la version d’image initiale, procédez comme suit :

Remarque :

L’unité d’hébergement de toutes les versions d’image doit être la même.

Accédez au nœud Images, sélectionnez une version d’image ou une définition d’image, puis cliquez sur Créer une version d’image.
Sur la page Définition d’image, vous pouvez modifier l’unité d’hébergement et resélectionner l’image principale et le profil de machine pour cette version d’image.
Si vous souhaitez que la configuration de la version d’image soit différente de la version d’image initialement configurée, configurez les paramètres sur les pages Spécification de la machine et Cartes réseau de la boîte de dialogue Créer une version d’image.
Ajoutez une description pour la version d’image. Cliquez sur Terminer.

Remarque :

Si la création de la version d’image échoue pour une raison quelconque, l’onglet Dépannage en bas fournit une option Réessayer.

Créer une spécification de version d’image préparée à l’aide de PowerShell

Les commandes PowerShell détaillées pour créer une spécification de version d’image préparée sont les suivantes :

Vérifiez les noms de définition d’image disponibles à l’aide de la commande Test-ProvImageDefinitionNameAvailable. Par exemple,
```
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>


```

Créez une définition d’image à l’aide de la commande New-ProvImageDefinition. Par exemple,

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession

<!--NeedCopy-->

Créez une nouvelle configuration pour la définition d’image dans la connexion d’hébergement spécifiée à l’aide de la commande Add-ProvImageDefinitionConnection.
```
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn


```

Créez une version d’image à l’aide de la commande New-ProvImageVersion. Par exemple,

New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

<!--NeedCopy-->

Ajoutez une spécification de version d’image principale à la version d’image à l’aide de la commande Add-ProvImageVersionSpec. Par exemple,
```
Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"


```
Remarque :

Vous ne pouvez ajouter qu’une seule spécification de version d’image principale à une version d’image pour une unité d’hébergement.

Créez une spécification de version d’image préparée à partir de la spécification de version d’image principale à l’aide de la commande New-ProvImageVersionSpec. Le paramètre SourceImageVersionSpecUid est dérivé de la commande Add-ProvImageVersionSpec. Par exemple,

 New-ProvImageVersionSpec
 -  -SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
 -  -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously

 <!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour créer une définition d’image, une version d’image et une spécification de version d’image préparée :

-  New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid

<!--NeedCopy-->

Remarque :

Toutes les spécifications de version d’image dans une définition d’image doivent appartenir à la même unité d’hébergement.

Une version d’image ne peut avoir qu’une seule spécification de version d’image principale et une seule spécification de version d’image préparée.

Toutes les spécifications de version d’image doivent avoir un profil de machine.

Partager des images préparées entre zones de disponibilité et régions

Vous pouvez désormais partager une seule image préparée entre différentes zones de disponibilité, liées à différentes unités d’hébergement, au sein de la même région AWS ou dans différentes régions pour vos instances gérées Amazon WorkSpaces Core. Cela vous permet d’utiliser une image préparée unique pour créer et mettre à jour des catalogues de machines MCS dans diverses zones de disponibilité et régions. Lors du partage entre différentes zones de disponibilité dans différentes régions, la version de l’image préparée sera copiée de la région d’origine vers les régions de destination.

Vous pouvez maintenir une seule image préparée et l’utiliser pour créer et mettre à jour des catalogues de machines dans plusieurs zones de disponibilité et régions liées à différentes unités d’hébergement. Cela réduit considérablement la surcharge de gestion de vos images, assure la cohérence des déploiements et rationalise le processus de provisionnement. Vous pouvez également mettre à jour de manière transparente les catalogues de machines existants avec des images préparées provenant d’une zone de disponibilité ou d’une région différente.

Cas d’utilisation

Gestion centralisée des images : Vous créez une image préparée dans une zone de disponibilité (par exemple, us-east-1a). Vous pouvez ensuite partager cette image avec d’autres zones de disponibilité comme us-east-1b au sein de la même région AWS us-east-1 ou us-west-1a dans une région us-west-1 différente. Cela permet à une seule image de servir plusieurs unités d’hébergement et simplifie la maintenance pour vous.
Création et mises à jour efficaces des catalogues : Vous pouvez utiliser une image préparée créée dans la AZ 1 (par exemple, us-east-1a) pour créer de nouveaux catalogues dans la AZ 1. Après avoir partagé cette image avec la AZ 2 (par exemple, us-east-1b), vous pouvez ensuite utiliser l’image partagée dans la AZ 2 pour créer et mettre à jour des catalogues dans la AZ 2.
Déploiements entre unités d’hébergement et connexions d’hébergement : Si votre environnement comporte plusieurs unités d’hébergement sous les mêmes régions AWS ou des régions différentes, vous pouvez partager efficacement les images préparées entre ces unités d’hébergement.

Limitations

Partage au sein du même compte AWS : Vous ne pouvez pas partager entre différents comptes AWS dans l’implémentation actuelle.

Considérations importantes

Ordre de suppression : Pour supprimer une spécification de version d’image préparée d’origine, vous devez d’abord supprimer toutes ses spécifications de version d’image partagée. Alternativement, vous devez supprimer les spécifications d’origine et partagées simultanément.
Dépendance de la version d’image : Lorsque vous supprimez une version d’image, vous devez d’abord supprimer toutes les configurations de partage qui dépendent de cette version d’image spécifique. Les catalogues que vous avez créés à partir de l’image d’origine (non partagée) peuvent rester intacts.
Rétrocompatibilité du catalogue : Vous pouvez mettre à jour les catalogues de machines existants que vous avez déployés avant l’introduction de cette fonctionnalité. Utilisez des images préparées que vous avez créées dans une zone de disponibilité ou une région différente de celle où vous avez initialement déployé le catalogue.
Suppression complète : Lorsque vous supprimez une image préparée, vous ne pouvez plus l’utiliser dans aucune zone de disponibilité où vous l’avez partagée ou créée à l’origine. De plus, une version d’image préparée ne peut pas être supprimée tant que tous les catalogues liés à cette version d’image préparée n’ont pas été supprimés.

Prérequis

Avant de configurer ou d’utiliser cette fonctionnalité, assurez-vous de remplir les conditions suivantes :

Votre environnement doit être un environnement d’instances gérées Amazon WorkSpaces Core.
Vous devez configurer plusieurs unités d’hébergement (chacune pouvant être liée à différentes zones de disponibilité) et connexions d’hôte (chacune pouvant être liée à une région différente) sous le même compte AWS.

Configuration via l’interface utilisateur de Studio

Vous pouvez partager des images préparées entre des zones de disponibilité liées à différentes unités d’hébergement à l’aide de l’interface utilisateur de Studio.

Pour partager une image préparée

Accédez au nœud Images de Studio et sélectionnez la version de l’image préparée que vous souhaitez partager avec d’autres zones de disponibilité.
Sélectionnez Gérer le partage d’images dans la barre de navigation supérieure pour gérer le partage d’images pour la version d’image sélectionnée.

1. Sur la page Gérer le partage d’images, sélectionnez une ou plusieurs ressources avec lesquelles vous souhaitez partager la version de l’image. Les ressources peuvent se trouver dans des zones de disponibilité différentes de celles de la version d’image d’origine.

Cliquez sur Enregistrer pour partager la version de l’image dans les ressources entre les autres zones de disponibilité. La version de l’image est mise à jour de manière à être partagée entre les différentes ressources que vous avez sélectionnées. Une fois terminé, utilisez la version de l’image pour créer des catalogues dans les zones de disponibilité où la version de l’image est partagée.

Pour supprimer le partage d’une image préparée

1. Sur le nœud Images de Studio, sélectionnez la version de l’image préparée dont vous souhaitez supprimer le partage.
1. Sélectionnez Gérer le partage d’images dans la barre de navigation supérieure pour gérer le partage d’images pour la version de l’image sélectionnée.
1. Décochez les cases d’une ou plusieurs ressources (zones de disponibilité) avec lesquelles vous souhaitez arrêter de partager la version de l’image.
Remarque :

Les ressources ne doivent plus avoir de catalogues associés et créés à partir de la version d’image partagée. Tous les catalogues créés à partir de la version d’image partagée à supprimer doivent être supprimés au préalable.

Cliquez sur Enregistrer pour supprimer le partage des ressources entre les zones de disponibilité effacées. La version de l’image est mise à jour de manière à ne plus être partagée dans ces zones de disponibilité.

Configuration via PowerShell

Alternativement, vous pouvez partager des images préparées entre des zones de disponibilité liées à différentes unités d’hébergement à l’aide de commandes PowerShell.

Pour partager une image préparée

Assurez-vous d’avoir l’ImageVersionSpecUid de l’image préparée que vous souhaitez partager. Vous pouvez la récupérer à l’aide de Get-ProvImageVersionSpec ou de commandes Get- similaires dans PowerShell.
Déterminez le HostingUnitName de la zone de disponibilité (peut être la même région ou une région différente) où vous souhaitez rendre l’image préparée disponible. Il s’agit du nom de l’unité d’hébergement que vous avez configurée pour cette zone de disponibilité spécifique.
Exécutez la commande Add-ProvImageVersionSpecHostingUnit : Utilisez la commande PowerShell suivante. Remplacez <ImageVersionSpecUid> par l’Uid de votre image et <targetHostingUnitName> par le nom de l’unité d’hébergement dans la zone de disponibilité cible avec laquelle vous souhaitez partager la spécification de version d’image :
```
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```
Après une exécution réussie, vous pouvez voir le statut de l’image dans l’interface utilisateur de Studio, indiquant qu’elle a été partagée avec l’unité d’hébergement spécifiée.

Pour supprimer le partage d’une image préparée

Assurez-vous d’avoir l’ImageVersionSpecUid de l’image préparée dont vous souhaitez supprimer le partage.
Déterminez le HostingUnitName de la zone de disponibilité à partir de laquelle vous souhaitez supprimer l’image partagée.
Exécutez la commande Remove-ProvImageVersionSpecHostingUnit : Utilisez la commande PowerShell suivante. Remplacez <ImageVersionSpecUid> par l’Uid de votre image et <targetHostingUnitName> par le nom de l’unité d’hébergement dans la zone de disponibilité cible à partir de laquelle vous souhaitez supprimer le partage de la spécification de version d’image :
```
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>


```

Paramètres 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.

Un catalogue de machines basé sur 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, le type de location, le type d’instance, les groupes de sécurité, les mappages réseau, les propriétés de volume EBS, l’optimisation EBS, les options de CPU, 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.

[[START_HIGHLIGHT]]

Remarque :

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

Seul le service de métadonnées d’instance (IMDS) V2 est pris en charge, et non IMDS V1. Pour plus d’informations, consultez Fonctionnement de la version 2 du service de métadonnées d’instance.

Tenance AWS

AWS propose les options de location suivantes : location partagée (le type par défaut) et location dédiée. La location partagée signifie que plusieurs instances Amazon WorkSpaces Core de différents clients peuvent résider sur le même matériel physique. La location dédiée signifie que vos instances Amazon WorkSpaces Core s’exécutent uniquement sur du matériel avec d’autres instances que vous avez déployées.

Remarque :

Seules les instances dédiées sont prises en charge (les hôtes dédiés ne sont actuellement pas pris en charge). D’autres clients n’utilisent pas le même matériel.

Le type de location est capturé à partir du profil de machine

Lorsque vous utilisez MCS pour créer un catalogue afin de provisionner des machines dans AWS, le type de location est capturé à partir du profil de machine.

Matériel partagé : Ce paramètre convient à la plupart des déploiements. Plusieurs clients partagent des éléments matériels même s’ils n’interagissent pas entre eux. L’utilisation de matériel partagé est l’option la moins chère pour exécuter vos instances Amazon EC2.
Instance dédiée : Ce paramètre est plus adapté aux déploiements ayant des exigences spécifiques en matière de sécurité ou de conformité. Avec une instance dédiée, vous bénéficiez toujours des avantages d’avoir un hôte séparé des autres clients AWS, mais vous ne payez pas pour l’hôte entier. Vous n’avez pas à vous soucier de la capacité de l’hôte, mais les instances vous sont facturées à un tarif plus élevé. De plus, les instances dédiées offrent une prise en charge limitée pour Bring Your Own License (BYOL).

Facturation flexible

Amazon WorkSpaces Core Managed Instances prend en charge deux modes de facturation :

Mode de facturation	Description
Mensuel	Facturation forfaitaire mensuelle fixe. Idéal pour les bureaux persistants et les charges de travail prévisibles.
Horaire	Facturation à l’usage. Il s’agit de la configuration AWS par défaut si aucun mode de facturation n’est explicitement spécifié.

Ces options offrent une flexibilité pour la gestion des coûts de calcul en fonction de la persistance et des modèles d’utilisation de votre charge de travail.

Cette fonctionnalité nécessite l’utilisation du service de facturation Amazon WorkSpaces. Par défaut, MCS utilise ce service pour provisionner et gérer les instances, ce qui vous permet de bénéficier de tarifs forfaitaires plus compétitifs pour les charges de travail persistantes.

Prérequis et considérations

Configuration du compte AWS : Votre compte AWS doit être configuré pour utiliser le service de facturation WorkSpaces. Bien que les comptes AWS soient basculés par défaut, certains clients peuvent demander à AWS de rester sur l’ancien service de facturation EC2 pour l’utilisation des instances gérées WorkSpaces Core.

Remarque :

Si votre compte utilise l’ancien service de facturation EC2, l’option de facturation Mensuel n’est pas disponible.
Connexion hôte : La facturation flexible s’applique uniquement aux connexions hôtes Amazon WorkSpaces Core. Elle n’est pas prise en charge pour les connexions hôtes AWS EC2 standard.
Instances Spot : Les instances Spot ne sont pas prises en charge avec le service de facturation WorkSpaces.
Facturation mixte : Un compte AWS doit utiliser soit la facturation WorkSpaces, soit la facturation EC2 pour les instances gérées Core. Un mélange des deux au sein d’un même compte n’est pas pris en charge.
Compatibilité : Seuls des types d’instance, des types de plateforme (OS) et des types de location spécifiques sont compatibles avec certains modes de facturation. MCS effectue une vérification préalable pour s’assurer que vos sélections (offre de service, profil de machine et image préparée) correspondent au mode de facturation choisi.

Consultez Créer un catalogue de machines avec un mode de facturation spécifique.

Créer un catalogue

Une image préparée et un profil de machine sont requis pour créer des catalogues d’instances gérées Amazon WorkSpaces Core. Vous pouvez utiliser une instance de machine virtuelle AWS ou une version de modèle de lancement AWS comme entrée de profil de machine.

Remarque :

Actuellement, la création de catalogues de machines virtuelles persistantes et non persistantes (la propriété CleanOnBoot est True ou False) est prise en charge.

Avant de créer un catalogue d’instances gérées Amazon WorkSpaces Core, vous devez avoir terminé la création :

D’une connexion aux instances gérées Amazon WorkSpaces Core. Consultez Connexion aux instances gérées Amazon WorkSpaces Core
D’une image préparée.

Vous pouvez créer un catalogue à l’aide de :

Studio
PowerShell

Créer un catalogue à l’aide de Studio

Créer un catalogue de machines à partir du nœud Images

Utilisez l’option Créer un catalogue dans le nœud Images pour créer un catalogue à l’aide de la version de l’image.

Vous pouvez également sélectionner la version lors de la création d’un catalogue dans le nœud Catalogues de machines, en la liant à l’option d’image préparée dans le flux de travail de création de catalogue. Consultez Créer un catalogue de machines à partir du nœud Catalogues de machines.

Pour créer un catalogue de machines MCS à partir du nœud Images, procédez comme suit :

1. Sélectionnez une version d’image et cliquez sur Créer un catalogue. Cliquez sur Suivant sur la page Introduction.

Sur les pages Gestion des machines et Image, les paramètres sont présélectionnés en fonction de la version d’image sélectionnée. Sur la page Image, saisissez une note pour l’image préparée sélectionnée.
Remplissez les paramètres sur les pages suivantes.
Sur la page Résumé, vérifiez les détails du catalogue de machines. Saisissez un nom et une description pour le catalogue de machines. Cliquez sur Terminer.
Accédez au nœud Catalogues de machines pour voir le catalogue de machines créé.

Créer un catalogue de machines à partir du nœud Catalogues de machines

Pour créer un catalogue de machines MCS à partir du nœud Catalogues de machines, procédez comme suit :

Cliquez sur Catalogues de machines dans le volet de navigation de gauche.
Cliquez sur Créer un catalogue de machines. La page Configuration du catalogue de machines apparaît.
Sur la page Type de machine, sélectionnez un type de machine pour le catalogue, par exemple, OS multi-session.
Sur la page Gestion des machines, sélectionnez les paramètres suivants :
1. Sélectionnez Machines gérées par l’alimentation (par exemple, machines virtuelles ou PC lames).
2. Sélectionnez Technologie de provisionnement Citrix. Ensuite, sélectionnez Citrix Machine Creation Services™.
3. Dans le champ Ressources, sélectionnez les ressources (zone de disponibilité ou zone locale) que vous avez configurées lors de la création de la connexion hôte et cliquez sur Suivant.
Sur la page Expérience de bureau, sélectionnez un bureau aléatoire ou statique que vous souhaitez que les utilisateurs aient lorsqu’ils se connectent. Si un bureau statique est sélectionné, spécifiez ensuite si vous souhaitez enregistrer les modifications apportées par l’utilisateur sur le disque local (persistant ou non persistant).
Sur la page Image, cliquez sur Sélectionner une image pour sélectionner une image préparée pour le catalogue de machines. Sélectionnez la version préparée que vous avez créée. Cliquez sur le nom de la version de l’image. Pour afficher plus de détails sur la version d’image sélectionnée, cliquez sur le numéro de version, qui est souligné. Cliquez sur Terminé.

[[END_HIGHLIGHT]]

Le profil de machine associé à l'image préparée apparaît et ses propriétés matérielles (par exemple, type d'instance, type de location, mappages réseau, groupes de sécurité, propriétés de volume) sont utilisées pour créer des machines dans les catalogues. Pour modifier la source du profil de machine vers une autre VM ou version de modèle de lancement, cliquez sur le bouton de modification.

Sur la page Machines virtuelles :
1. Saisissez le nombre de machines virtuelles pour le catalogue.
2. La spécification de machine par défaut est affichée, basée sur le profil de machine. Pour la modifier, sélectionnez l’icône de modification et sélectionnez une spécification de machine.
Sur la page Cartes réseau, sélectionnez les cartes réseau (ou ENI) pour les machines virtuelles.
Sur la page Identités de machine, configurez le type d’identité de machine pour les machines du catalogue :
1. Pour configurer des machines jointes à un domaine (Active Directory local ou jointes de manière hybride à Microsoft Entra), sélectionnez le domaine et créez de nouveaux comptes AD pour les machines virtuelles à créer dans ce catalogue de machines. Les machines virtuelles provisionnées sont jointes au domaine sélectionné. Pour provisionner des machines non jointes à un domaine, sélectionnez l’option de non-jonction au domaine.
2. Spécifiez le schéma de nommage des comptes pour les nouveaux comptes à créer pour les machines virtuelles.
Sur la page Informations d’identification du domaine, cliquez sur Saisir les informations d’identification pour fournir les informations d’identification du domaine sélectionné. Saisissez le nom d’utilisateur et le mot de passe de niveau administrateur lorsque vous y êtes invité. Vous pouvez également utiliser un compte de service si vous avez déjà enregistré des informations d’identification de domaine en suivant notre documentation produit.
Parcourez les pages restantes jusqu’à la page Résumé. Saisissez un nom pour le catalogue de machines et sélectionnez Terminer pour créer le catalogue de machines.

Limitations relatives à la création d’un catalogue de machines dans une zone locale AWS

Certaines zones locales ne prennent en charge que certaines configurations matérielles (par exemple, la zone locale de Perth ne prend pas en charge les volumes GP3, uniquement les GP2).
Étant donné que seul gp2 est universellement pris en charge dans toutes les zones locales, et que toutes ne prennent pas en charge gp3, la création de disques d’identité utilise par défaut le type de volume gp2.
Vous devez sélectionner un profil de machine avec des spécifications matérielles prises en charge dans la zone locale souhaitée.
Les instantanés d’AMI d’images préparées et les instantanés de disques d’identité sont par défaut placés dans la région, plutôt que dans la zone locale (en raison des limitations d’AWS concernant la visibilité de la prise en charge des instantanés EBS dans les zones locales).
- Seules les zones locales prenant en charge les services EC2 et EBS complets sont des zones prises en charge.

Créer un catalogue à l’aide de PowerShell

Créer un catalogue à l’aide d’une spécification de version d’image préparée et d’un profil de machine

-  Créez un catalogue de machines non persistantes MCS à partir de la spécification de version d'image préparée à l'aide de la commande `New-ProvScheme`. Par exemple,

```

New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]

<!--NeedCopy--> ```

-  Créez un catalogue de machines persistantes MCS à partir de la spécification de version d'image préparée à l'aide de la commande `New-ProvScheme`. Par exemple,

```

-  New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”] 

<!--NeedCopy--> ```

Exemple de l’ensemble complet de commandes PowerShell pour créer un catalogue :

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "wsccatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "wsccatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName wsccatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName wsc -IdentityPoolName wsccatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName wsccatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid

<!--NeedCopy-->

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 de machines avec un mode de facturation spécifique

Vous pouvez spécifier le mode de facturation lors de la création d’un catalogue de machines en utilisant uniquement PowerShell actuellement.

Pour spécifier le mode de facturation via PowerShell, utilisez le paramètre CustomProperties dans la commande New-ProvScheme.

$custprop = "BillingMode,Monthly" 
 
New-ProvScheme -ProvisioningSchemeName "MyCatalog" ` 
-ImageVersionSpecUid $ImageVersionSpecUid ` 
-HostingUnitName "wsc-unit" ` 
-IdentityPoolName "MyIdentityPool" ` 
-MachineProfile "XdHyp:\HostingUnits\wsc-unit\machine-profile lt-123.launchtemplate\lt-123 (1).launchtemplateversion" ` 
-CustomProperties $custprop ` 
-CleanOnBoot

<!--NeedCopy-->

Remarque :

Si la propriété BillingMode est omise, le catalogue utilise par défaut le mode Hourly (par heure).

Modifier le mode de facturation d’un catalogue existant

Vous pouvez convertir un catalogue existant de Monthly (mensuel) à Hourly (par heure), ou vice versa. Cette modification peut s’appliquer aux machines virtuelles nouvelles et existantes du catalogue.

Considérations importantes pour les mises à jour

Fenêtre de service : Les machines virtuelles existantes doivent subir une fenêtre de service ou un cycle d’alimentation pour appliquer la modification de facturation.
Validation : MCS valide que les types d’instances et les plateformes existants sont compatibles avec le nouveau mode de facturation avant d’appliquer la modification.

Mettre à jour à l’aide de PowerShell

Pour mettre à jour le mode de facturation uniquement des nouvelles machines virtuelles ajoutées à un catalogue, mettez à jour la propriété personnalisée du mode de facturation du schéma de provisionnement :
```
 $custprop = "BillingMode,Hourly"

 -  Set-ProvScheme -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop

 
```

Pour mettre à jour le mode de facturation des machines virtuelles nouvelles et existantes dans un catalogue, créez une nouvelle version du schéma de provisionnement avec la propriété personnalisée mise à jour, et appliquez la nouvelle version à toutes les machines virtuelles :

 -  $custprop = "BillingMode,Hourly"

     New-ProvSchemeVersion -ProvisioningSchemeName "MyCatalog" -CustomProperties $custprop

 -  New-ProvSchemeHardwareUpdate -ProvisioningSchemeVersion 2 `
 -  -StartsNow -AllVMs `
     -MaxDurationInMinutes 100 `
 -  -ProvisioningSchemeName "MyCatalog"

 <!--NeedCopy-->

Surveiller les informations de facturation

Vous pouvez vérifier le mode de facturation pour les catalogues et les machines virtuelles individuelles.

Exécutez les commandes PowerShell suivantes pour vérifier l’éligibilité de votre compte à la facturation :

Renvoie BillingMode dans le cadre des CustomProperties

 -  Get-ProvScheme –ProvisioningSchemeName “"MyCatalog" "  | Select  ProvisioningSchemeName,  CustomProperties

 <!--NeedCopy-->

Renvoie BillingMode dans le cadre des VMInfo

 -  Get-ProvVMDetails –ProvisioningSchemeName “"MyCatalog" "  | Select-Object  -ExpandProperty VMInfo

 <!--NeedCopy-->

Dépannage et validation

MCS inclut des vérifications préliminaires pour éviter les configurations incompatibles. Vous pouvez rencontrer les erreurs suivantes lors de la création ou de la modification d’un catalogue :

NoInstanceConfigFoundForBillingMode : se produit si l’offre de service (type d’instance), la location et le type de plateforme sélectionnés ne sont pas pris en charge pour le mode de facturation choisi.
Spot Instance Not Supported : si vous tentez d’utiliser des instances Spot avec une connexion d’hôte WorkSpaces, la validation échoue.
Restriction de facturation EC2 : si votre compte AWS utilise l’ancien modèle de facturation EC2, toute tentative de définir un mode de facturation mensuel entraîne une erreur de validation.

Créer un catalogue avec une version de modèle de lancement à l’aide de PowerShell

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 de 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 ont priorité sur les valeurs de profil de machine de ces propriétés.

Offre de service
Réseaux

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 à l’aide d’une version de 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 de modèle de lancement 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” `
- -ImageVersionSpecUid ‘24dfb047-e867-527g-896c-25664xxxxx1t’ `
- -CleanOnBoot ` -MachineProfile “XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion”
```

Enregistrez un schéma de provisionnement en tant que catalogue de brokers. 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.

Mettre à jour la source du 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. 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 (lors de l’installation du VDA, sélectionnez l’option d’inclure le pilote MCSIO dans l’installation), vous pouvez créer un catalogue non persistant compatible MCSIO.

Note :

L’option de configuration de MCSIO avec uniquement un cache disque (sans cache mémoire) à l’aide de Studio a été supprimée pour tous les hyperviseurs et environnements de services cloud.

Créer un catalogue compatible MCSIO

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

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

Note :

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 les suivantes :

WBCDiskStorageType : Définit le type de volume, qui est utilisé pour le disque temporaire dans les instances gérées Amazon WorkSpaces Core. 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 cache doit être conservé ou supprimé chaque fois que les instances gérées Amazon WorkSpaces Core sont mises hors tension. S’il est défini sur true, le disque cache est conservé. S’il est défini sur false (valeur par défaut), le disque 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 les instances gérées Amazon WorkSpaces Core sont mises 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 (valeur 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 compatible MCSIO :

Ouvrez la fenêtre PowerShell.
Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.
Créez un catalogue de brokers 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 cache ou de recréer un disque racine à partir de leur modèle.

Chiffrer les disques du système d’exploitation et d’identité

Vous pouvez créer un catalogue de machines virtuelles 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 et le disque d’identité (ID).

Les clés gérées par AWS sont automatiquement renouvelées chaque année.
Les clés gérées par le client sont facultatives pour le renouvellement automatique et peuvent être gérées manuellement.

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

Pour le chiffrement des disques du système d’exploitation et d’identité, configurez l’une des options suivantes :

Utilisez une image préparée 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 (machine virtuelle 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 une image AMI préparée.
Vous ne pouvez pas chiffrer directement des volumes ou des instantanés EBS existants non chiffrés, ni modifier la clé KMS d’un volume chiffré existant. Pour ce faire, vous devez :
1. Créer un nouvel instantané de ce volume.
2. Créer un nouveau volume à partir de cet instantané.
3. Chiffrer 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 :

Une image préparée (créée à l’aide de la gestion d’images à partir d’une image maître dont le disque est chiffré).
Un 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 a priorité sur la clé KMS de l’image préparée.
Si aucune entrée de profil de machine n’est fournie, la clé KMS de l’image AMI préparée est utilisée pour chiffrer les disques des machines virtuelles 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 préparée (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 préparée n’est pas chiffrée, les disques des machines virtuelles du catalogue ne sont pas chiffrés.
Lorsque l’image préparée est chiffrée, une machine virtuelle 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 inclure :

Une entrée de profil de machine avec un volume contenant une nouvelle clé KMS.
Une image préparée créée à partir de l’image principale avec une AMI chiffrée à l’aide de la gestion des images.

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’un profil de machine existant est présent, 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 de mise à jour d’image d’une AMI d’image préparée chiffrée vers une AMI d’image préparée 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 préparée (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éez une connexion à AWS.
Créez une image principale (AMI) avec NitroTPM et/ou le démarrage sécurisé UEFI activés.
Créez une image préparée à partir de l’image principale. Consultez Créer une image préparée pour les instances gérées Amazon WorkSpaces Core.
Créez un catalogue de machines en sélectionnant l’image préparée avec NitroTPM et le démarrage sécurisé UEFI activés dans le menu de création de catalogue de Citrix 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 prenant en charge NitroTPM et le démarrage sécurisé UEFI

Vous pouvez créer une AMI à partir d’une machine virtuelle sur laquelle NitroTPM et/ou le démarrage sécurisé UEFI sont 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 sur la place de marché AWS.
2. Téléchargez un VDA mono 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 machines virtuelles nouvellement ajoutées. Cependant, vous obtenez des erreurs dans les scénarios suivants :

Mode de démarrage des AMI	L’AMI prend-elle en charge NitroTPM ?	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

Copier les balises sur les machines virtuelles

Vous pouvez copier les balises des cartes réseau et des disques (disque d’identité, disque de cache en écriture différée et disque du système d’exploitation) spécifiées dans le profil de machine vers les machines virtuelles 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 machine virtuelle AWS ou version de modèle de lancement AWS). Cette fonctionnalité s’applique aux catalogues de machines et aux machines virtuelles persistants et non persistants.

Remarque :

Sur la console AWS EC2, vous ne pouvez pas voir les valeurs de 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 des balises.

Si une source de profil de machine (machine virtuelle 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 machine virtuelle obtient les balises des deux interfaces réseau.

Filtrer les instances de machines virtuelles à l’aide de PowerShell

Une instance de machine virtuelle AWS que vous utilisez comme machine virtuelle de profil de machine doit être compatible pour que le catalogue de machines puisse être créé et fonctionner correctement. Pour lister les instances de machines virtuelles AWS qui peuvent être utilisées comme machines virtuelles d’entrée de profil de machine, vous pouvez utiliser la commande Get-HypInventoryItem. La commande peut paginer et filtrer l’inventaire des machines virtuelles 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. Ce paramètre contrôle le nombre d’éléments à renvoyer.
- -Skip : La valeur par défaut est 0. Ce paramètre contrôle le nombre d’éléments à ignorer à partir du début absolu (ou de 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. Ce paramètre est utilisé avec -MaxRecords pour renvoyer l’ensemble suivant d’enregistrements correspondants ou l’ensemble précédent d’enregistrements correspondants.
- -ContinuationToken : Renvoie les éléments immédiatement après (ou avant si ForwardDirection est false) mais n’inclut pas l’élément donné dans le ContinuationToken.

Exemples de pagination :

Pour renvoyer un seul enregistrement du modèle de machine avec le nom le plus bas. Le champ AdditionalData contient les valeurs TotalItemsCount et 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 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 a la balise et que la valeur est égale à celle donné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é présente 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é Warning. Par exemple :

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

<!--NeedCopy-->

Où aller ensuite

Gérer les catalogues créés à l’aide d’images préparées

Plus d’informations

Gestion des images
Pour des exemples PowerShell GitHub d’Amazon WorkSpaces Core, consultez citrix-mcs-sdk-samples-Amazon WorkSpaces Core

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 ?

Créer des catalogues à l’aide d’images préparées dans des instances gérées Amazon WorkSpaces Core

May 4, 2026

Contributeur:

May 4, 2026

Contributeur:

Dans cet article

Étapes clés
Créer une définition d’image et une version d’image initiale à l’aide de Studio
Créer une spécification de version d’image préparée à l’aide de PowerShell
Partager des images préparées entre zones de disponibilité et régions
Paramètres réseau pendant la préparation de l’image
Un catalogue de machines basé sur un profil de machine
Tenance AWS
Facturation flexible
Créer un catalogue
Créer un catalogue à l’aide de Studio
Créer un catalogue à l’aide de PowerShell
Catalogue compatible MCSIO
Chiffrer les disques du système d’exploitation et d’identité
Activer NitroTPM et le démarrage sécurisé UEFI pour les instances de machines virtuelles
Copier les balises sur les machines virtuelles
Filtrer les instances de machines virtuelles à l’aide de PowerShell
Où aller ensuite
Plus d’informations

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