Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

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

April 8, 2026
Contributeur: 
C C

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 créé :

  1. Une connexion aux instances gérées Amazon WorkSpaces Core. Consultez Connexion aux instances gérées Amazon WorkSpaces Core
  2. 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 le 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.

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’intégralité de l’hôte. 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 de l’apport de votre propre licence (BYOL).

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

Créer un catalogue à l’aide de Web 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.
    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.
    1. Renseignez les paramètres sur les pages suivantes.
    1. 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.
    1. 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 :

  1. Cliquez sur Catalogues de machines dans le volet de navigation de gauche.
    1. Cliquez sur Créer un catalogue de machines. La page Configuration du catalogue de machines apparaît.
  1. Sur la page Type de machine, sélectionnez un type de machine pour le catalogue, par exemple, OS multi-session.

  2. 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 d’hôte, puis cliquez sur Suivant.
  3. 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 en outre si vous souhaitez enregistrer les modifications apportées par l’utilisateur sur le disque local (persistant ou non persistant).

  4. 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é.

    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.

  5. Sur la page Machines virtuelles :

    1. Saisissez le nombre de VM 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.
  6. Sur la page Cartes réseau, sélectionnez les cartes réseau (ou ENI) pour les VM.

  7. 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.
  8. 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 auparavant en consultant notre documentation produit.
  9. 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 disques d’identity 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é 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 et d’un profil de machine préparés

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

  1. Exécutez la commande Set-ProvScheme. Par exemple :

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

Créer un catalogue avec une version de modèle de lancement à 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 du profil de machine ou explicitement en tant que paramètres dans les commandes New-ProvScheme ou Set-ProvScheme. Si elles sont fournies dans les commandes New-ProvScheme ou Set-ProvScheme, elles ont priorité sur les valeurs de ces propriétés dans le profil de machine.

  • 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 :
  1. Ouvrez une fenêtre PowerShell.
  2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.

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

    ```

    1. 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-->
    1. 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' `
 <!--NeedCopy-->

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

  2. 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 machine d’une version de modèle de lancement vers une machine virtuelle :

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

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.

Consultez 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 (VM ou modèle de lancement) qui contient un volume racine EBS chiffré.

Limitations 

-  Tenez compte des limitations suivantes :
  • MCS ne prend actuellement en charge qu’un seul disque sur l’AMI d’image préparée.

    • Vous ne pouvez pas chiffrer directement les volumes ou 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. 1. Créer un nouveau volume à partir de cet instantané. 1. 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 à l’aide de :

  • Image préparée (créée à l’aide de la gestion d’images à partir d’une image principale dotée d’un disque chiffré)
  • 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 est prioritaire 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 d’image préparée est utilisée pour chiffrer les disques des VM du catalogue.
  • Si le profil de machine contient des mappages de périphériques de bloc, les périphériques de bloc présents dans le modèle d’image 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 VM du catalogue ne sont pas chiffrés.
  • Lorsque l’image préparée est chiffrée, une VM source de profil de machine ou un modèle de lancement doit avoir un volume racine chiffré pour être considéré comme une entrée valide.

Modifier un catalogue existant

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

  • Une entrée de profil de machine avec un volume contenant une nouvelle clé KMS.
  • Une 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 VM ajoutées au catalogue sont chiffrés avec la nouvelle clé KMS.
  • Pour mettre à jour les paramètres de chiffrement lorsqu’il existe un profil de machine existant, exécutez Set-ProvScheme avec un nouveau profil de machine.
  • Vous ne pouvez pas modifier un catalogue existant pour passer de volumes chiffrés à des volumes non chiffrés. Vous ne pouvez pas effectuer une mise à jour d’image d’une AMI 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 VM

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é. En conséquence, les VM 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 VM 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

    1. Configurez votre environnement AWS.
  1. Créez une connexion à AWS.
  2. Créez une image principale (AMI) activée avec NitroTPM et/ou le démarrage sécurisé UEFI.
  3. 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.
  4. 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 Web Studio ou lors de la création d’un schéma de provisionnement à l’aide de commandes PowerShell.

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

  1. Vous pouvez créer une AMI à partir d’une VM qui a NitroTPM et/ou le démarrage sécurisé UEFI activé.

    1. Créez l’instance à partir des images de la place de marché AWS. Exemple : recherchez TPM-Windows_Server-2022-English-Full-Base on the aws-marketplace.
    2. Téléchargez un VDA à session unique ou multiple.
    3. Créez une AMI à partir de cette VM.

  2. Utilisez la commande register-image :

    --boot-mode (string)
--tpm-support (string)
<!--NeedCopy-->

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

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

  • 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 VM 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 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 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és 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 Baliser les interfaces réseau sous les Balises de ressource de version de modèle de lancement. Cependant, vous pouvez exécuter la commande PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 pour voir les spécifications de balise.
  • Si une source de profil de machine (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 machine virtuelle à 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 machine virtuelle 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. Cela contrôle le nombre d’éléments à renvoyer.
    • -Skip : La valeur par défaut est 0. Cela contrôle le nombre d’éléments à ignorer depuis le début absolu (ou la fin absolue) de la liste dans l’hyperviseur.
  • Le mode de défilement utilise les paramètres -MaxRecords, -ForwardDirection et -ContinuationToken pour permettre le défilement des enregistrements :
    • -ForwardDirection : La valeur par défaut est True. Ceci est utilisé avec -MaxRecords pour renvoyer soit l’ensemble suivant d’enregistrements correspondants, soit l’ensemble précédent d’enregistrements correspondants.
    • -ContinuationToken : Renvoie les éléments immédiatement après (ou avant si ForwardDirection est false) mais sans inclure l’élément donné dans 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
 <!--NeedCopy-->

  • 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 "mon_nom" : Si la chaîne donnée correspond à une partie d’un nom d’AMI, alors 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 '{ "Clé0": "Valeur0", "Clé1": "Valeur1", "Clé2": "Valeur2" }' : 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
 <!--NeedCopy-->

    Remarque :

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

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

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

Filtrage sur le paramètre AdditionalData :

Le paramètre de filtre AdditionalData liste 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é Avertissement. Par exemple :

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

Étapes suivantes

Plus d’informations

Créer un catalogue d’instances gérées Amazon WorkSpaces Core
April 8, 2026
Contributeur: 
C C
April 8, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.