Documentation produit
Citrix DaaS
Voir PDF

Créer un catalogue AWS

September 27, 2024
Contributeur: 
C

La section Créer des catalogues de machines décrit les assistants qui permettent de créer un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements de virtualisation AWS.

Remarque :

Avant de créer un catalogue AWS, vous devez terminer la création d’une connexion à AWS. Voir Connexion à AWS.

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

Lors de la préparation de l’image, une machine virtuelle (machine virtuelle) de préparation est créée sur la base de la machine virtuelle d’origine. Cette machine virtuelle de préparation est déconnectée du réseau. Pour déconnecter le réseau de la machine virtuelle 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ù le GUID est généré de manière aléatoire.

Location AWS

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

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

Configuration requise pour le provisioning des hôtes AWS

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

Configurer la location d’hôte dédié AWS à l’aide de Studio

Lorsque vous utilisez MCS pour créer un catalogue pour provisionner des machines dans AWS, la page Création d’un catalogue de machines > Sécurité présente les options suivantes :

  • Utiliser le matériel partagé. Ce paramètre convient à la plupart des déploiements. Plusieurs clients partagent le matériel même s’ils n’interagissent pas les uns avec les autres. L’utilisation de matériel partagé est l’option la moins coûteuse pour exécuter vos instances Amazon EC2.
  • Utiliser un hôte dédié. Un hôte Amazon EC2 dédié est un serveur physique avec une capacité d’instance EC2 entièrement dédiée, ce qui vous permet d’utiliser les licences logicielles par socket ou par machine virtuelle. Les hôtes dédiés ont une utilisation prédéfinie basée sur le type d’instance. Par exemple, un hôte dédié alloué de types d’instance C4 Large ne peut pas exécuter plus de 16 instances. Consultez le site AWS pour plus d’informations.

  • Utiliser une instance dédiée. Ce paramètre est plus approprié aux déploiements nécessitant des exigences spécifiques en matière de sécurité et conformité. Avec une instance dédiée, vous bénéficiez toujours des avantages d’un hôte séparé des autres clients AWS, mais vous ne payez pas pour la totalité de l’hôte. Vous n’avez pas besoin de vous soucier de la capacité de l’hôte, mais vous êtes facturé à un taux plus élevé pour les instances.

    Ce paramètre convient aux déploiements avec des restrictions de licence ou exigences de sécurité qui nécessitent d’utiliser un hôte dédié. Avec un hôte dédié, vous possédez la totalité d’un hôte physique et vous êtes facturé sur une base horaire. Posséder cet hôte vous permet de faire tourner autant d’instances EC2 que cet hôte le permet, sans frais supplémentaires.

Remarque :

Vous pouvez supprimer les disques d’identité de préparation disponibles si aucune tâche de création de catalogue ou de mise à jour d’image n’est en cours.

Configurer les locataires d’hôtes dédiés AWS à l’aide de PowerShell

Vous pouvez également provisionner des hôtes dédiés AWS via PowerShell. Utilisez l’applet de commande New-ProvScheme en définissant le paramètre TenancyType sur Host.

Capturer les propriétés d’instance AWS

Lorsque vous créez un catalogue de machines à provisionner à l’aide de MCS (Machine Creation Services) dans AWS, vous sélectionnez une AMI (Amazon Machine Image) pour représenter l’image principale de ce catalogue. À partir de cette AMI, MCS utilise un instantané du disque.

Conseil :

Pour utiliser la capture de propriétés d’instance AWS, une machine virtuelle doit être associée à l’AMI.

MCS lit les propriétés de l’instance à partir de laquelle l’AMI a été prise et applique le rôle IAM (Identity Access Management) et les balises de la machine aux machines provisionnées d’un catalogue donné. Lors de l’utilisation de cette fonctionnalité facultative, le processus de création du catalogue recherche l’instance source de l’AMI sélectionnée, en lisant un ensemble limité de propriétés. Ces propriétés sont ensuite stockées dans un modèle de lancement AWS, qui est utilisé pour provisionner des machines pour ce catalogue. Toute machine du catalogue hérite des propriétés d’instance capturées.

Les propriétés capturées incluent :

  • Rôles IAM : appliqués aux instances provisionnées.
  • Balises : appliquées aux instances provisionnées, à leur disque et aux cartes réseau. Ces balises sont appliquées aux ressources Citrix transitoires, notamment : compartiment et objets S3, AMI, instantanés et modèles de lancement.

Conseil :

Le balisage des ressources Citrix transitoires est facultatif et est configurable à l’aide de la propriété personnalisée AwsOperationalResourcesTagging. Pour appliquer correctement les balises et créer un catalogue AWS avec balisage des ressources opérationnelles, ne supprimez pas l’instance EC2 qui a été utilisée pour créer l’image AMI.

Capturer les propriétés d’instance AWS

Vous pouvez utiliser cette fonctionnalité en spécifiant une propriété personnalisée, AwsCaptureInstanceProperties, lors de la création d’un schéma de provisioning pour une connexion d’hébergement AWS :

New-ProvScheme -CustomProperties “AwsCaptureInstanceProperties,true” …<standard provscheme parameters

Pour plus d’informations, reportez-vous au New-ProvScheme.

Remarque :

AwsCaptureInstanceProperties est obsolète. Nous vous recommandons plutôt d’utiliser des profils de machine pour spécifier les propriétés des machines virtuelles.

Baliser une ressource opérationnelle

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

Important :

La création de catalogues en capturant une propriété d’instance et un modèle de lancement est nécessaire pour utiliser le balisage des ressources opérationnelles.

Pour créer un catalogue AWS, vous devez d’abord créer une AMI pour l’instance qui sera l’image principale. MCS lit les balises de cette instance et les incorpore dans le modèle de lancement. Les balises du modèle de lancement sont ensuite appliquées à toutes les ressources Citrix créées dans votre environnement AWS, notamment :

  • Machines virtuelles
  • Disques machine virtuelle
  • Interfaces réseau machine virtuelle
  • Compartiments S3
  • Objets S3
  • Modèles de lancement
  • AMI

Application des propriétés d’instance AWS et balisage des ressources opérationnelles dans Studio

Lorsque vous créez un catalogue pour provisionner des machines dans AWS à l’aide de MCS, vous pouvez contrôler si le rôle IAM et les propriétés de balise doivent être appliqués à ces machines. Vous pouvez également contrôler si vous souhaitez appliquer des balises de machine aux ressources opérationnelles. Vous disposez des deux options suivantes :

Balises de machine AWS et propriétés de modèle

  • Appliquer les propriétés du modèle de machine aux machines virtuelles
    • Contrôle si le rôle IAM et les propriétés de balise associées au modèle de machine sélectionné doivent être appliqués aux machines virtuelles de ce catalogue.
  • Appliquer balises de machine aux ressources opérationnelles
    • Contrôle si des balises de machine doivent être appliquées à chaque élément créé dans votre environnement AWS afin de faciliter le provisioning des machines. Les ressources opérationnelles sont créées en tant que sous-produits de la création de catalogue. Elles incluent des ressources temporaires et persistantes, telles que les instances de VM de préparation et les images de machine d’Amazon.

Appliquer une balise à une ressource opérationnelle à l’aide de PowerShell

Pour utiliser PowerShell pour baliser des ressources :

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

Pour appliquer une balise à une ressource de VM provisionnée, utilisez la nouvelle propriété personnalisée AwsOperationalResourcesTagging. La syntaxe de cette propriété est la suivante :

New-ProvScheme -CustomProperties “AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true” …<standard provscheme parameters>

Créer un catalogue de machines basé sur un profil de machine à l’aide de PowerShell

Vous pouvez utiliser un profil de machine pour capturer les propriétés matérielles d’une instance EC2 (VM) ou une version de Launch Template et les appliquer aux machines provisionnées. Les propriétés capturées peuvent inclure, par exemple, les propriétés du volume EBS, le type d’instance, l’optimisation EBS, les options d’UC, le type de locataire, la capacité de mise en veille prolongée et d’autres configurations AWS prises en charge.

Vous pouvez utiliser une instance AWS EC2 (VM) ou une version d’AWS Launch Template comme entrée de profil de machine.

Remarque :

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

Remarques importantes

Points importants à prendre en considération lors de la création d’un catalogue de machines MCS :

  • Si vous ajoutez les paramètres des propriétés matérielles d’une machine dans les commandes New-ProvScheme et Set-ProvScheme, les valeurs fournies dans les paramètres remplacent les valeurs du profil de la machine.
  • Si vous définissez AwsCaptureInstanceProperties comme true et ne définissez pas la propriété MachineProfile, seuls les rôles et les balises IAM sont capturés.

  • Vous ne pouvez pas régler AwsCaptureInstanceProperties etMachineProfile en même temps.

    **Remarque :

    AwsCaptureInstanceProperties est obsolète.

  • Si aucun profil de machine n’est spécifié, vous devez indiquer explicitement les valeurs des propriétés suivantes :

    • Groupe de sécurité
    • Interface réseau élastique ou réseau virtuel
  • Vous ne pouvez activer AwsOperationalResourcesTagging que si vous activez AwsCaptureInstanceProperties ou spécifiez un profil de machine.

Points importants à prendre en considération après la création d’un catalogue de machines MCS :

  • Vous ne pouvez pas redéfinir un catalogue reposant sur un profil de machine en tant que catalogue ne reposant pas sur un profil de machine.

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

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

  1. Ouvrez une fenêtre PowerShell.
  2. Exécutez asnp citrix* pour charger des modules PowerShell propres à Citrix.

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

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

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

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

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é de mise en veille prolongée 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 du 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 machines depuis 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 de l’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 en tant qu’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 sur les machines virtuelles VDA provisionnées.

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

  • Offre de services
  • Réseaux
  • Groupes de sécurité
  • Type de location

Remarque :

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

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

  1. Ouvrez une fenêtre PowerShell.
  2. Exécutez asnp citrix* pour charger des modules PowerShell propres à Citrix.

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

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

  4. Créez un pool d’identités s’il n’a pas été créé. Par exemple :

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

  5. 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" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

  6. Enregistrez le 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-->
  7. 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 machines depuis 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 machines depuis une machine virtuelle vers une version de modèle de lancement, procédez comme suit :

     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 depuis une version de modèle de lancement vers une machine virtuelle, procédez comme suit :

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

Crypter le système d’exploitation et les disques d’identité

Vous pouvez créer un catalogue persistant et non persistant de machines virtuelles avec des clés AWS KMS (clé gérée par le client et clé gérée par AWS) pouvant être utilisées pour crypter 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.
  • Le renouvellement automatique des clés gérées par le client est facultatif et ces clés peuvent être gérées manuellement.

Pour en savoir plus sur les clés KMS, consultez les documents AWS suivants :

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

  • Utiliser une image principale cryptée (par exemple, une AMI créée à partir d’une instance ou d’un instantané contenant un volume racine EBS crypté avec une clé KMS)
  • Utiliser une source de profil de machine (machine virtuelle ou modèle de lancement) contenant un volume racine EBS crypté.

Limitations

Tenez compte des limitations suivantes :

  • Actuellement, MCS ne prend en charge qu’un seul disque sur l’AMI de l’image principale.

  • Vous ne pouvez pas crypter directement des volumes EBS ou des instantanés non cryptés existants, ni modifier la clé KMS d’un volume crypté existant. Pour cela, vous devez procéder comme suit :

    1. Créez un instantané de ce volume.
    2. Créez un volume à partir de cet instantané
    3. Cryptez le nouveau volume.

Consultez les documents AWS suivants :

Créer un catalogue avec cryptage de disque

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

  • L’image principale
  • Le profil de la machine

Points à prendre en compte lors de l’utilisation d’une entrée de profil de machine :

  • La clé KMS de l’entrée de profil de machine a priorité sur la clé KMS de l’image principale.
  • Si aucune entrée de profil de machine n’est spécifiée, la clé KMS de l’AMI principale est utilisée pour crypter les disques des machines virtuelles du catalogue.
  • Si des mappages de périphériques en bloc sont présents dans le profil de machine, les périphériques en bloc présents dans le modèle d’image principale (AMI) et dans le profil de machine doivent correspondre. Par exemple, si l’AMI d’un périphérique est définie sur /dev/sda1, un périphérique doit également être défini sur le profil de machine /dev/sda1.
  • S’il n’y a pas de clé dans la source du profil de machine et que l’image principale n’est pas cryptée, les disques des machines virtuelles du catalogue ne sont pas cryptés.
  • Lorsque l’image principale est cryptée, une machine virtuelle source de profil de machine ou un modèle de lancement doit avoir un volume racine crypté 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 de façon à obtenir :

  • Une entrée de profil de machine dont le volume contient une nouvelle clé KMS.
  • Un modèle d’image principale AMI crypté avec une nouvelle clé KMS.

Remarques importantes :

  • Les volumes des nouvelles machines virtuelles ajoutées au catalogue sont cryptés avec la nouvelle clé KMS.
  • Pour mettre à jour les paramètres de cryptage lorsqu’un profil de machine existe déjà, exécutez Set-ProvScheme avec un nouveau profil de machine.
  • Vous ne pouvez pas modifier un catalogue existant pour transformer les volumes cryptés en volumes non cryptés. Vous ne pouvez pas mettre à jour une image pour remplacer une AMI principale cryptée en AMI principale non cryptée.

Copier des balises sur des machine virtuelle

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

Remarque :

  • Sur la console AWS EC2, vous ne pouvez pas voir les valeurs des interfaces réseau de balises sous les balises de ressource de version du 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 des balises.
  • Si une source de profil de machine (version de machine virtuelle ou de modèle de lancement) possède deux interfaces réseau (eni-1 et eni-2) et que eni-1 possède la balise t1 et eni-2 la balise t2, 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 soit créé et fonctionne correctement. Pour répertorier les instances de machines virtuelles AWS pouvant être utilisées comme machines virtuelles d’entrée de profil de machine, vous pouvez utiliser la commande Get-HypInventoryItem. La commande permet de consulter et de 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 permet de contrôler le nombre d’éléments à renvoyer.
    • -Skip : la valeur par défaut est 0. Ce paramètre permet de contrôler 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é conjointement avec -MaxRecords pour renvoyer l’ensemble suivant ou l’ensemble précédent d’enregistrements correspondants.
    • -ContinuationToken : ce paramètre renvoie les éléments suivants (ou précédents si ForwardDirection est défini sur false), mais sans inclure l’élément indiqué dans ContinuationToken.

Exemples de pagination :

  • Pour renvoyer un seul enregistrement du modèle de machine portant le nom figurant en haut de la liste, procédez comme suit. Le champ AdditionalData contient TotalItemsCount et TotalFilteredItemsCount :

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

  • Pour renvoyer dix enregistrements du modèle de machine portant le nom figurant en bas de la liste, procédez comme suit :

     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 figurant en haut de la liste, procédez comme suit :

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

  • Pour renvoyer un tableau d’enregistrements à partir du modèle de machine associé à la valeur donnée ContinuationToken, procédez comme suit :

     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 du nom d’une AMI, l’AMI est incluse dans le résultat Get. Par exemple :

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

  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }' : si une AMI possède au moins l’une de ces balises, elle est incluse dans le résultat Get . Par exemple :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
 <!--NeedCopy-->

    Remarque :

    Deux valeurs de balise sont prises en charge. La valeur de balise Not Tagged correspond aux éléments qui ne possèdent pas la balise spécifiée dans leur liste de balises. La valeur de balise All values correspond aux éléments qui possèdent la balise, quelle que soit la valeur de la balise. Dans le cas contraire, la correspondance ne se produit que si l’élément possède la balise et que si la valeur est égale à celle indiqué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 avec le paramètre AdditionalData :

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

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

Vous pouvez également ajouter un paramètre -Warn pour spécifier les machines virtuelles incompatibles. Les machines virtuelles sont incluses dans un champ AdditionalData nommé Warning. Par exemple :

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

Autres ressources

Informations supplémentaires

Créer un catalogue AWS
September 27, 2024
Contributeur: 
C
September 27, 2024
Contributeur: 
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.