Citrix DaaS™

Créer un catalogue d’instances gérées Amazon WorkSpaces Core

May 4, 2026

Contributeur:

Créer des catalogues de machines décrit les assistants qui créent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux instances gérées Amazon WorkSpaces Core.

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.

Prérequis

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. Consultez Créer une image préparée pour les instances gérées Amazon WorkSpaces Core.

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.

Remarque :

Les propriétés de volume 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 l’IMDS V1. Pour plus d’informations, consultez Fonctionnement de la version 2 du service de métadonnées d’instance.

Location 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 convient mieux 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’intégralité de l’hôte. Vous n’avez pas à vous soucier de la capacité de l’hôte, mais vous êtes facturé à un tarif plus élevé pour les instances. De plus, les instances dédiées offrent une prise en charge limitée de la licence BYOL (Bring Your Own License).

Facturation flexible

Les instances gérées Amazon WorkSpaces Core prennent en charge deux modes de facturation :

Mode de facturation Description

Mensuel	Facturation forfaitaire mensuelle fixe. Idéal pour les postes de travail 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 d’une tarification forfaitaire plus compétitive 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 la facturation WorkSpaces ou 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 (Service Offering, Machine Profile et Prepared Image) 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 la création de catalogues d’instances gérées Amazon WorkSpaces Core. Vous pouvez utiliser une instance de VM AWS ou une version de modèle de lancement AWS comme entrée de profil de machine.

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 vous connectant à 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 :

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

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

Renseignez 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 afficher 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 s’affiche.
Sur la page Type de machine, sélectionnez un type de machine pour le catalogue, par exemple, SE 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 provisioning Citrix. Sélectionnez ensuite 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 d’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 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 d’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é.

Le profil de machine associé à l’image préparée s’affiche 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 VM pour le catalogue.
2. La spécification de machine par défaut s’affiche, qui est 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 VM.
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 à Microsoft Entra hybride), sélectionnez le domaine et créez de nouveaux comptes AD pour les VM à créer dans ce catalogue de machines. Les VM 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 VM.
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 concernant 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 disque d’ID 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’ID 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é du support 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 MCS non persistant à 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 MCS persistant à 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 qui a été 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.

Utiliser PowerShell

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.

Modifier le mode de facturation d’un catalogue existant

Vous pouvez convertir un catalogue existant de Monthly à Hourly, ou vice versa. Cette modification peut s’appliquer aux VM nouvelles et existantes du catalogue.

Considérations importantes pour les mises à jour

Fenêtre de service : Les VM 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 provisioning :
```
 $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 provisioning 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 des catalogues et des machines virtuelles individuelles.

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

Renvoie BillingMode dans le cadre de CustomProperties

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

 <!--NeedCopy-->

Renvoie BillingMode dans le cadre de 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.
-  **EC2 billing restriction** : 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 machine virtuelle vers une version de modèle de lancement et d’une version de modèle de lancement vers une machine virtuelle.

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 machines virtuelles 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, vous obtenez une erreur appropriée.

Pour créer un catalogue à l’aide d’une version de modèle de lancement comme entrée de profil de machine :

1. 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 provisioning 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"

 <!--NeedCopy-->

Enregistrez un schéma de provisioning 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 machine virtuelle vers une version de modèle de lancement et d’une version de modèle de lancement vers une machine virtuelle. Par exemple :

Pour mettre à jour l’entrée d’un catalogue de profils de machine d’une machine virtuelle 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 machines 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.

Remarque :

L’option de configuration de MCSIO avec uniquement un cache de disque (sans cache de 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 :

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.

Remarque :

La valeur de WriteBackCacheDiskSize doit être supérieure à zéro, car au moins 1 Go de stockage de 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, 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 (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 (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.

1. 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 VM au catalogue.

Améliorer les performances de démarrage avec MCSIO

Vous pouvez améliorer les performances de démarrage des VM si vous activez MCSIO et définissez les propriétés personnalisées PersistWBC et PersistOSDisk sur true. Avec un tel paramètre, les VM 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 VM 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 la rotation automatique et peuvent être gérées manuellement.
- Vous pouvez consulter les documents AWS suivants pour plus d’informations sur les clés KMS :
Concepts AWS KMS
Fonctionnement de la rotation automatique des clés
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 (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 une AMI d’image préparée.
Vous ne pouvez pas chiffrer directement des volumes ou des 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 :

Une image préparée (créée à l’aide de la gestion d’images à partir d’une image principale 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’AMI de l’image 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 avoir :

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 d’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’il existe un profil de machine, 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 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)), sauf en 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) activée avec NitroTPM et/ou le démarrage sécurisé UEFI.
Créez une image préparée à partir de l’image principale. Voir 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 NitoTPM 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 sur la place de marché aws.
2. Téléchargez un VDA à session unique ou multiple.
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 :

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

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 obtiendrez des erreurs 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

Copier les balises sur les machines virtuelles

Vous pouvez copier les balises sur les cartes réseau et les disques (disque d’identité, disque de cache en écriture 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 et machines virtuelles persistants et non persistants.

Remarque :

Sur la console AWS EC2, vous ne pouvez pas voir les valeurs Tag Network Interfaces sous 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 (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.

Filtrer les instances de VM à l’aide de PowerShell

Une instance de VM AWS 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 de VM AWS 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. 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 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. 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 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 VM 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 VM incompatibles. Les VM 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

Pour la gestion d’un catalogue Amazon WorkSpaces Core, consultez Gérer un catalogue d’instances gérées Amazon WorkSpaces Core

Plus d’informations

Environnements de virtualisation AWS
Connexion aux instances gérées Amazon WorkSpaces Core
Gestion des images
Créer une image préparée pour les instances gérées Amazon WorkSpaces Core
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 un catalogue d’instances gérées Amazon WorkSpaces Core

May 4, 2026

Contributeur:

May 4, 2026

Contributeur:

Dans cet article

Prérequis
Paramètres réseau pendant la préparation de l’image
Un catalogue de machines basé sur un profil de machine
Location 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 VM à l’aide de PowerShell
Où aller ensuite
Plus d’informations

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