Produktdokumentation
Citrix Virtual Apps and Desktops 7 2311
PDF anzeigen

Einen AWS-Katalog erstellen

June 5, 2026
Beitrag von: 
C

Maschinenkataloge erstellen beschreibt die Assistenten, die einen Maschinenkatalog erstellen. Die folgenden Informationen behandeln Details, die spezifisch für AWS-Virtualisierungsumgebungen sind.

Hinweis:

Bevor Sie einen AWS-Katalog erstellen, müssen Sie die Erstellung einer Verbindung zu AWS abgeschlossen haben. Siehe Verbindung zu AWS.

Einschränkung

Ab Citrix Virtual Apps and Desktops™ 2203 LTSR und höher führt das MCS AWS-Plug-in einen DescribeInstanceTypes AWS-API-Aufruf durch, und wenn dieser erfolgreich ist, verwendet MCS den aus der API-Antwort erstellten Bestandsnamen.

Wenn Sie daher von CVAD 1912 auf 2203 oder höher aktualisieren, deaktivieren Sie die DefineInstanceType Berechtigung in AWS und aktualisieren Sie dann den vorhandenen Katalog mit dem Set-ProvScheme Befehl, um dem AWS-Benennungsschema zu entsprechen. Fügen Sie dann die DescribeInstanceType Berechtigungen wieder hinzu, nachdem die Katalogaktualisierung abgeschlossen ist und das Serviceangebot dem AWS-Benennungsschema entspricht.

Netzwerkeinstellung während der Image-Vorbereitung

Während der Image-Vorbereitung wird eine Vorbereitungs-VM (virtuelle Maschine) basierend auf der ursprünglichen VM erstellt. Diese Vorbereitungs-VM ist vom Netzwerk getrennt. Um die Netzwerkverbindung von der Vorbereitungs-VM zu trennen, wird eine Netzwerksicherheitsgruppe erstellt, die den gesamten eingehenden und ausgehenden Datenverkehr verweigert. Diese Netzwerksicherheitsgruppe bleibt bestehen und wird wiederverwendet. Der Name der Netzwerksicherheitsgruppe ist Citrix.XenDesktop.IsolationGroup-GUID, wobei GUID zufällig generiert wird.

AWS-Mandantenfähigkeit konfigurieren

AWS bietet die folgenden Mandantenfähigkeitsoptionen:

  • Gemeinsame Mandantenfähigkeit (Standardtyp): Mehrere Amazon EC2-Instanzen von verschiedenen Kunden können auf derselben physischen Hardware residieren.
  • Dedizierte Mandantenfähigkeit: Ihre EC2-Instanzen laufen nur auf Hardware mit anderen Instanzen, die Sie bereitgestellt haben. Andere Kunden verwenden nicht dieselbe Hardware.

Sie können MCS verwenden, um dedizierte AWS-Hosts mithilfe von PowerShell bereitzustellen.

Dedizierte AWS-Host-Mandantenfähigkeit mit PowerShell konfigurieren

Sie können einen Maschinenkatalog erstellen, dessen Host-Tenancy über PowerShell definiert ist.

Ein dedizierter Amazon [EC2]-Host ist ein physischer Server mit [EC2] Instanzkapazität, der vollständig dediziert ist, wodurch Sie vorhandene Pro-Socket- oder Pro-VM-Softwarelizenzen verwenden können.

Dedizierte Hosts haben eine voreingestellte Auslastung basierend auf dem Instanztyp. Beispielsweise ist ein einzelner zugewiesener dedizierter Host vom Instanztyp C4 Large auf die Ausführung von 16 Instanzen beschränkt. Weitere Informationen finden Sie auf der AWS-Website.

Die Anforderungen für die Bereitstellung auf AWS-Hosts umfassen:

  • Ein importiertes BYOL (Bring Your Own License)-Image (AMI). Verwenden und verwalten Sie mit dedizierten Hosts Ihre vorhandenen Lizenzen.
  • Eine Zuweisung dedizierter Hosts mit ausreichender Auslastung, um Bereitstellungsanforderungen zu erfüllen.
  • Auto-Placement aktivieren.

Um mit PowerShell auf einem dedizierten Host in AWS bereitzustellen, verwenden Sie das Cmdlet New-ProvScheme mit dem Parameter TenancyType, der auf Host gesetzt ist.

Weitere Informationen finden Sie in der Citrix Developer Documentation.

Maschineneigenschaften aus AMIs erfassen

Wenn Sie einen Katalog zur Bereitstellung von Maschinen mit Machine Creation Services (MCS) in AWS erstellen, wählen Sie ein AMI aus, das das Master-/Golden Image dieses Katalogs darstellt. Von diesem AMI verwendet MCS einen Snapshot der Festplatte. In früheren Versionen mussten Sie, wenn Sie Rollen oder Tags auf Ihren Maschinen haben wollten, die AWS-Konsole verwenden, um diese einzeln festzulegen. Diese Funktionalität ist standardmäßig aktiviert.

Tipp:

Um die Erfassung von AWS-Instanzeigenschaften zu verwenden, muss eine VM mit dem AMI verknüpft sein.

Um diesen Prozess zu verbessern, liest MCS Eigenschaften von der Instanz, von der das AMI erstellt wurde, und wendet die Identity Access Management (IAM)-Rolle und Tags der Maschine auf die für einen bestimmten Katalog bereitgestellten Maschinen an. Bei Verwendung dieser optionalen Funktion findet der Katalogerstellungsprozess die ausgewählte AMI-Quellinstanz und liest eine begrenzte Anzahl von Eigenschaften. Diese Eigenschaften werden dann in einer AWS-Startvorlage gespeichert, die zur Bereitstellung von Maschinen für diesen Katalog verwendet wird. Jede Maschine im Katalog erbt die erfassten Instanzeigenschaften.

Erfasste Eigenschaften umfassen:

  • IAM-Rollen – angewendet auf bereitgestellte Instanzen.
  • Tags – angewendet auf bereitgestellte Instanzen, deren Datenträger und NICs. Diese Tags werden auf temporäre Citrix®-Ressourcen angewendet, einschließlich: S3-Buckets und -Objekte sowie AMIs, Snapshots und Startvorlagen.

Tipp:

Die Kennzeichnung temporärer Citrix-Ressourcen ist optional und kann über die benutzerdefinierte Eigenschaft AwsOperationalResourcesTagging konfiguriert werden.

AWS-Instanzeigenschaft erfassen

Sie können diese Funktion nutzen, indem Sie beim Erstellen eines Bereitstellungsschemas für eine AWS-Hostingverbindung eine benutzerdefinierte Eigenschaft AwsCaptureInstanceProperties angeben:

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

Weitere Informationen finden Sie in der Citrix Developer Documentation.

Hinweis:

Die AwsCaptureInstanceProperties ist veraltet.

Maschineneigenschaften aus Maschinenprofilen erfassen

Beim Erstellen eines Katalogs zur Bereitstellung von AWS-Maschinen mit MCS können Sie ein Maschinenprofil verwenden, um bestimmte Maschineneigenschaftseinstellungen vorab festzulegen.

Gehen Sie dazu wie folgt vor:

  1. Speichern Sie die Maschinenprofile in derselben Verfügbarkeitszone wie die Ressourcen, in denen Sie diesen Katalog erstellen.
  2. Wählen Sie auf der Seite Maschinenvorlage des Katalogerstellungs-Assistenten die Option Maschinenprofil verwenden. Es werden Maschinenprofile angezeigt, die sich in derselben verfügbaren Zone wie die von Ihnen ausgewählten Ressourcen befinden.
  3. Wählen Sie bei Bedarf ein Maschinenprofil aus.

Hinweis:

Sie können entweder ein Maschinenprofil oder ein AMI verwenden, um Maschineneigenschaften zu erfassen. Wenn Sie in Web Studio die Option Maschinenprofil verwenden auswählen, wird die Option Maschinenvorlageneigenschaften auf virtuelle Maschinen anwenden automatisch ausgeblendet.

AWS-Betriebsressource taggen

Beim Erstellen eines Katalogs zur Bereitstellung von Maschinen in AWS mit MCS können Sie steuern, ob die IAM-Rolle und die Tag-Eigenschaften auf diese Maschinen angewendet werden. Sie können auch steuern, ob Maschinentags auf Betriebsressourcen angewendet werden.

Ein Amazon Machine Image (AMI) stellt eine Art virtueller Appliance dar, die zum Erstellen einer virtuellen Maschine in der Amazon Cloud-Umgebung, allgemein als EC2 bezeichnet, verwendet wird. Sie verwenden ein AMI, um Dienste bereitzustellen, die die EC2-Umgebung nutzen. Wenn Sie einen Katalog zur Bereitstellung von Maschinen mit MCS für AWS erstellen, wählen Sie das AMI als Golden Image für diesen Katalog aus.

Wichtig:

Das Erstellen von Katalogen durch Erfassen einer Instanzeigenschaft und einer Startvorlage ist für die Verwendung der Tagging von Betriebsressourcen erforderlich.

Um einen AWS-Katalog zu erstellen, müssen Sie zuerst ein AMI für die Instanz erstellen, die das Golden Image sein soll. MCS liest die Tags von dieser Instanz und integriert sie in die Startvorlage. Die Tags der Startvorlage werden dann auf alle in Ihrer AWS-Umgebung erstellten Citrix-Ressourcen angewendet, einschließlich:

  • Virtuelle Maschinen
  • VM-Datenträger
  • VM-Netzwerkschnittstellen
  • S3-Buckets
  • S3-Objekte
  • Startvorlagen
  • AMIs

Eine Betriebsressource taggen

So taggen Sie Ressourcen mit PowerShell:

  1. Öffnen Sie ein PowerShell-Fenster vom DDC-Host aus.
  2. Führen Sie den Befehl asnp citrix aus, um Citrix-spezifische PowerShell-Module zu laden.

Um eine Ressource für eine bereitgestellte VM zu taggen, verwenden Sie die neue benutzerdefinierte Eigenschaft AwsOperationalResourcesTagging. Die Syntax für diese Eigenschaft lautet:

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

Nächste Schritte

Tags auf VMs kopieren

Sie können Tags auf NICs und Datenträgern (Identitätsdatenträger, Write-Back-Cache-Datenträger und OS-Datenträger), die im Maschinenprofil angegeben sind, auf neu erstellte VMs in einem MCS-Maschinenkatalog kopieren. Sie können diese Tags in jeder der Maschinenprofilquellen (AWS VM-Instanz oder AWS Startvorlagenversion) angeben. Diese Funktion ist für persistente und nicht-persistente Maschinenkataloge und VMs anwendbar.

Hinweis:

  • In der AWS EC2-Konsole können Sie die Werte für Tag Network Interfaces nicht unter den Launch Template Version Resource Tags sehen. Sie können jedoch den PowerShell-Befehl aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 ausführen, um die Tag-Spezifikationen anzuzeigen.
  • Wenn eine Maschinenprofilquelle (VM oder Startvorlagenversion) zwei Netzwerkschnittstellen (eni-1 und eni-2) hat und eni-1 den Tag t1 und eni-2 den Tag t2 hat, dann erhält die VM die Tags beider Netzwerkschnittstellen.

Katalog mit einem Maschinenprofil erstellen

Wenn Sie einen Katalog zur Bereitstellung von Maschinen mit Machine Creation Services™ (MCS) in AWS erstellen, können Sie jetzt ein Maschinenprofil verwenden, um die Hardwareeigenschaften von einer EC2-Instanz (VM) oder einer Startvorlagenversion zu erfassen und auf die bereitgestellten Maschinen anzuwenden. Erfasste Eigenschaften können beispielsweise EBS-Volume-Eigenschaften, Instanztyp, EBS-Optimierung und andere unterstützte AWS-Konfigurationen umfassen. Beim Bearbeiten des Katalogs kann das Maschinenprofil der bereitgestellten Maschinen durch Angabe einer anderen VM oder Startvorlage geändert werden.

Hinweis:

EBS-Volume-Eigenschaften werden nur von einem Maschinenprofil abgeleitet.

Wichtige Überlegungen

Wichtige Überlegungen beim Erstellen eines MCS-Maschinenkatalogs:

  • Wenn Sie Hardwareeigenschaftenparameter der Maschine in den Befehlen New-ProvScheme und Set-ProvScheme hinzufügen, überschreiben die in den Parametern angegebenen Werte die Werte im Maschinenprofil.
  • Wenn Sie AwsCaptureInstanceProperties als true festlegen und die Eigenschaft MachineProfile nicht festlegen, werden nur IAM-Rollen und Tags erfasst.

  • Sie können AwsCaptureInstanceProperties und MachineProfile nicht gleichzeitig festlegen.

    **Hinweis:

    Der AwsCaptureInstanceProperties ist veraltet.

  • Sie müssen die Werte der folgenden Eigenschaften explizit angeben:

    • TenancyType
    • Security Group
    • NIC oder virtuelles Netzwerk
  • Sie können AwsOperationalResourcesTagging nur aktivieren, wenn Sie AwsCaptureInstanceProperties aktivieren oder ein Maschinenprofil angeben.

Wichtige Überlegungen nach dem Erstellen eines MCS-Maschinenkatalogs:

  • Nur die neuen VMs, die dem Katalog hinzugefügt werden, sind von der Änderung betroffen.
  • Sie können einen Katalog nicht von einem maschinenprofilbasierten in einen nicht-maschinenprofilbasierten Katalog ändern.

Maschinenkatalog mit einem Maschinenprofil erstellen

So erstellen Sie einen Maschinenkatalog mit einem Maschinenprofil:

  1. Öffnen Sie ein PowerShell-Fenster.
  2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

  3. Erstellen Sie einen Identitätspool, falls noch nicht geschehen. Zum Beispiel:

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

  4. Führen Sie den Befehl New-ProvScheme aus. Zum Beispiel:

    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. Schließen Sie die Katalogerstellung ab. Weitere Informationen finden Sie unter Citrix PowerShell SDK.

So aktualisieren Sie das Maschinenprofil in einem Katalog, der ursprünglich mit einem Maschinenprofil bereitgestellt wurde:

  1. Führen Sie den Befehl Set-ProvScheme aus. Zum Beispiel:

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

Katalog mit Startvorlagenversion erstellen

Sie können einen MCS-Maschinenkatalog mit einer Startvorlagenversion als Maschinenprofileingabe erstellen. Sie können die Eingabe eines Maschinenprofilkatalogs auch von einer VM zu einer Startvorlagenversion und von einer Startvorlagenversion zu einer VM aktualisieren.

In der AWS EC2-Konsole können Sie die Instanzkonfigurationsinformationen einer Startvorlage zusammen mit der Versionsnummer angeben. Wenn Sie die Startvorlagenversion als Maschinenprofileingabe beim Erstellen oder Aktualisieren eines Maschinenkatalogs angeben, werden die Eigenschaften dieser Version der Startvorlage auf die bereitgestellten VDA-VMs kopiert.

Die folgenden Eigenschaften können mithilfe der Maschinenprofileingabe oder explizit als Parameter in den Befehlen New-ProvScheme oder Set-ProvScheme bereitgestellt werden. Wenn sie in den Befehlen New-ProvScheme oder Set-ProvScheme bereitgestellt werden, haben sie Vorrang vor den Maschinenprofilwerten dieser Eigenschaften.

  • Dienstangebot
  • Netzwerke
  • Sicherheitsgruppen
  • Mandantentyp

Hinweis:

Wenn das Dienstangebot nicht in der Startvorlage des Maschinenprofils oder als Parameter im Befehl New-ProvScheme bereitgestellt wird, erhalten Sie einen entsprechenden Fehler.

So erstellen Sie einen Katalog mithilfe einer Startvorlagenversion als Maschinenprofileingabe:

  1. Öffnen Sie ein PowerShell-Fenster.
  2. Führen Sie asnp citrix* aus, um die Citrix-spezifischen PowerShell-Module zu laden.

  3. Rufen Sie die Liste der Startvorlagenversionen einer Startvorlage ab. Zum Beispiel:

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

  4. Erstellen Sie einen Identitätspool, falls noch nicht geschehen. Zum Beispiel:

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

  5. Erstellen Sie ein Bereitstellungsschema mit einer Startvorlagenversion als Maschinenprofileingabe. Zum Beispiel:

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

    Sie können auch Parameter wie Service Offering, Sicherheitsgruppen, Tenancy und Netzwerke überschreiben. Zum Beispiel:

    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-01xxxx).launchtemplate\lt-01xxxx (1).launchtemplateversion" `
-ServiceOffering "XDHyp:\HostingUnits\xxxd-ue1a\T3 Large Instance.serviceoffering"
<!--NeedCopy-->

  6. Bereitstellungsschema als Broker-Katalog registrieren. Zum Beispiel:

    New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->
  7. Erstellung des Katalogs abschließen. Weitere Informationen finden Sie unter Citrix PowerShell SDK

Sie können die Eingabe eines Maschinenprofilkatalogs auch von einer VM in eine Startvorlagenversion und von einer Startvorlagenversion in eine VM aktualisieren. Zum Beispiel:

  • So aktualisieren Sie die Eingabe eines Maschinenprofilkatalogs von einer VM in eine Startvorlagenversion:

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

  • So aktualisieren Sie die Eingabe eines Maschinenprofilkatalogs von einer Startvorlagenversion in eine VM:

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

VM-Instanzen filtern

Eine AWS EC2-Instanz, die Sie als VM für ein Maschinenprofil verwenden, muss kompatibel sein, damit der Maschinenkatalog korrekt erstellt und funktioniert. Um die AWS EC2-Instanzen aufzulisten, die als Eingabe-VMs für Maschinenprofile verwendet werden können, können Sie den Befehl Get-HypInventoryItem verwenden. Der Befehl kann das Inventar der auf einer Hosting-Einheit verfügbaren VMs seitenweise anzeigen und filtern.

Paginierung:

Get-HypInventoryItem unterstützt zwei Paginierungsmodi:

  • Der Paging-Modus verwendet die Parameter -MaxRecords und -Skip, um Sätze von Elementen zurückzugeben:
    • -MaxRecords: Der Standardwert ist 1. Dies steuert, wie viele Elemente zurückgegeben werden sollen.
    • -Skip: Der Standardwert ist 0. Dies steuert, wie viele Elemente vom absoluten Anfang (oder absoluten Ende) der Liste im Hypervisor übersprungen werden sollen.
  • Der Scrolling-Modus verwendet die Parameter -MaxRecords, -ForwardDirection und -ContinuationToken, um das Scrollen der Datensätze zu ermöglichen:
    • -ForwardDirection: Der Standardwert ist True. Dies wird zusammen mit -MaxRecords verwendet, um entweder den nächsten Satz übereinstimmender Datensätze oder den vorherigen Satz übereinstimmender Datensätze zurückzugeben.
    • -ContinuationToken: Dies gibt die Elemente unmittelbar nach (oder vor, wenn ForwardDirection false ist), aber nicht das im ContinuationToken angegebene Element zurück.

Beispiele für Paginierung:

  • Um einen einzelnen Datensatz der Maschinen-Vorlage mit dem niedrigsten Namen zurückzugeben. Das Feld AdditionalData enthält TotalItemsCount und TotalFilteredItemsCount:

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

  • Um 10 Datensätze der Maschinen-Vorlage mit dem niedrigsten Namen zurückzugeben:

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

  • Um ein Array von Datensätzen zurückzugeben, die mit dem höchsten Namen enden:

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

  • Um ein Array von Datensätzen zurückzugeben, die bei der Maschinen-Vorlage beginnen, die mit dem angegebenen ContinuationToken verknüpft ist:

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

Filterung:

Die folgenden zusätzlichen optionalen Parameter werden für die Filterung unterstützt. Sie können diese Parameter mit den Paginierungsoptionen kombinieren.

  • -ContainsName "my_name": Wenn die angegebene Zeichenfolge einem Teil eines AMI-Namens entspricht, wird das AMI in das Get Ergebnis aufgenommen. Zum Beispiel:

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

  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Wenn ein AMI mindestens eines dieser Tags hat, wird es in das Get Ergebnis aufgenommen. Zum Beispiel:

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

    Hinweis:

    Zwei Tag-Werte werden unterstützt. Der Tag-Wert Nicht getaggt entspricht Elementen, die das angegebene Tag nicht in ihrer Tag-Liste haben. Der Tag-Wert Alle Werte entspricht Elementen, die das Tag unabhängig vom Wert des Tags haben. Andernfalls erfolgt die Übereinstimmung nur, wenn das Element das Tag hat und der Wert dem im Filter angegebenen Wert entspricht.

  • -Id "ami-0a2d913927e0352f3": Wenn das AMI der angegebenen ID entspricht, wird es in das Get Ergebnis aufgenommen. Zum Beispiel:

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

Filterung nach AdditionalData-Parameter:

Der Filterparameter AdditionalData listet Vorlagen oder VMs basierend auf ihrer Fähigkeit, ihrem Serviceangebot oder jeder Eigenschaft auf, die in AdditionalData enthalten ist. Zum Beispiel:

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

Sie können auch einen -Warn Parameter hinzufügen, um die inkompatiblen VMs anzugeben. Die VMs werden mit einem AdditionalData Feld namens Warning eingeschlossen. Zum Beispiel:

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

Weitere Informationen

Einen AWS-Katalog erstellen
June 5, 2026
Beitrag von: 
C
June 5, 2026
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.