Einen AWS-Katalog erstellen

Last published : Nov 13, 2026
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.
Related information
Maschinenkataloge erstellen

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 aus, 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 Befehl Set-ProvScheme, 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 wird vom Netzwerk getrennt. Um die Netzwerkverbindung der Vorbereitungs-VM zu trennen, wird eine Netzwerksicherheitsgruppe erstellt, um jeglichen eingehenden und ausgehenden Datenverkehr zu verweigern. Diese Netzwerksicherheitsgruppe bleibt bestehen und wird wiederverwendet. Der Name der Netzwerksicherheitsgruppe ist Citrix.XenDesktop.IsolationGroup-GUID, wobei die GUID zufällig generiert wird.

AWS-Tenancy konfigurieren

AWS bietet die folgenden Mandantenfähigkeitsoptionen:
  • Shared Tenancy (der Standardtyp): Mehrere Amazon EC2-Instanzen von verschiedenen Kunden können auf demselben physischen Hardwarestück residieren.
  • Dedicated Tenancy: Ihre EC2-Instanzen laufen nur auf Hardware mit anderen Instanzen, die Sie bereitgestellt haben. Andere Kunden verwenden nicht dasselbe Hardwarestück.
Sie können MCS verwenden, um dedizierte AWS-Hosts mithilfe von PowerShell bereitzustellen.

AWS Dedicated Host Tenancy mit PowerShell konfigurieren

Sie können einen Maschinenkatalog mit über PowerShell definierter Host-Tenancy erstellen.
Ein dedizierter Amazon Host ist ein physischer Server mit 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. Zum Beispiel 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-Image (Bring Your Own License) (AMI). Bei dedizierten Hosts verwenden und verwalten Sie Ihre vorhandenen Lizenzen.
  • Eine Zuweisung dedizierter Hosts mit ausreichender Auslastung, um Bereitstellungsanforderungen zu erfüllen.
  • aktivieren Sie die automatische Platzierung.
Um mithilfe von PowerShell auf einem dedizierten Host in AWS bereitzustellen, verwenden Sie das Cmdlet New-ProvScheme mit dem Parameter TenancyType, der auf Host festgelegt ist.
Weitere Informationen finden Sie in der Citrix Developer Documentation.

Maschineneigenschaften aus AMIs erfassen

Wenn Sie einen Katalog erstellen, um Maschinen mithilfe von Machine Creation Services (MCS) in AWS bereitzustellen, wählen Sie ein AMI aus, das das Master-/Golden Image dieses Katalogs darstellt. Von diesem AMI verwendet MCS einen Snapshot des Datenträgers. In früheren Versionen mussten Sie, wenn Sie Rollen oder Tags auf Ihren Maschinen haben wollten, diese einzeln über die AWS-Konsole festlegen. 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 (AWS Launch Template) 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 – werden auf bereitgestellte Instanzen angewendet.
  • Tags – werden auf bereitgestellte Instanzen, deren Datenträger und NICs angewendet. Diese Tags werden auf temporäre Citrix®-Ressourcen angewendet, darunter: S3-Bucket 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 verwenden, 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:
Das AwsCaptureInstanceProperties ist veraltet. Wir empfehlen stattdessen, Maschinenprofile zu verwenden, um Maschineneigenschaften für VMs anzugeben.

Maschineneigenschaften aus Maschinenprofilen erfassen

Wenn Sie einen Katalog zur Bereitstellung von AWS-Maschinen mit MCS erstellen, 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 Katalogerstellungsassistenten die Option Maschinenprofil verwenden. Maschinenprofile, die sich in derselben verfügbaren Zone wie die von Ihnen ausgewählten Ressourcen befinden, werden angezeigt.
  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 sollen. Sie können auch steuern, ob Maschinentags auf Betriebsressourcen angewendet werden sollen.
Ein Amazon Machine Image (AMI) stellt eine Art virtueller Appliance dar, die zur Erstellung 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-Funktion für 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>

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 gilt für persistente und nicht-persistente Maschinenkataloge und VMs.
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

Sie können ein Maschinenprofil verwenden, um die Hardwareeigenschaften 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, CPU-Optionen, Tenancy-Typ, Hibernationsfähigkeit und andere unterstützte AWS-Konfigurationen umfassen.
Sie können eine AWS EC2-Instanz (VM) oder eine AWS-Startvorlagenversion als Eingabe für das Maschinenprofil verwenden.
Hinweis:
  • EBS-Volume-Eigenschaften werden nur aus einem Maschinenprofil abgeleitet.
  • MCS stellt VMs mit Identitätsdatenträgern vom Volume-Typ GP3 bereit. Da der GP3-Volume-Typ die günstigste von AWS angebotene Option ist, minimiert diese Funktion die Kosten. Die Implementierung gilt nur für VMs, die einem neuen Katalog hinzugefügt werden, und für neue VMs, die einem vorhandenen Katalog hinzugefügt werden. Vor dieser Funktion erstellte vorhandene VMs haben weiterhin ID-Datenträger mit dem Volume-Typ GP2, es sei denn, der ID-Datenträger wird zurückgesetzt.

Wichtige Überlegungen

Die wichtigen Überlegungen bei der Erstellung eines MCS-Maschinenkatalogs:
  • Wenn Sie Maschinenhardware-Eigenschaftsparameter 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:
    Das AwsCaptureInstanceProperties ist veraltet.
  • Wenn kein Maschinenprofil bereitgestellt wird, müssen Sie die Werte der folgenden Eigenschaften explizit angeben:
    • Sicherheitsgruppe
    • ENI oder virtuelles Netzwerk
  • Sie können AwsOperationalResourcesTagging nur aktivieren, wenn Sie AwsCaptureInstanceProperties aktivieren oder ein Maschinenprofil angeben.
Die wichtigen Überlegungen nach dem Erstellen eines MCS-Maschinenkatalogs:
  • 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
  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'
  5. Schließen Sie die Katalogerstellung ab. Weitere Informationen finden Sie unter Citrix PowerShell SDK.

Maschinenprofil aktualisieren

Um das Maschinenprofil in einem Katalog zu aktualisieren, der ursprünglich mit einem Maschinenprofil bereitgestellt wurde, gehen Sie wie folgt vor. Sie können auch den Mandantentyp und die Ruhezustandsfunktion der Maschinenprofilquelle ändern, während Sie einen MCS-Maschinenkatalog bearbeiten.
  1. Set-ProvScheme-Befehl ausführen. Zum Beispiel:
    Set-ProvScheme `
    -ProvisioningSchemeUid "<ID" `
    -MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"

Katalog mit Startvorlagenversion erstellen

Sie können einen MCS-Maschinenkatalog mit einer Startvorlagenversion als Maschinenprofileingabe erstellen. Sie können auch die Eingabe eines Maschinenprofilkatalogs 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 Eingabe des Maschinenprofils oder explizit als Parameter in New-ProvScheme oder Set-ProvScheme-Befehlen bereitgestellt werden. Wenn sie in New-ProvScheme oder Set-ProvScheme-Befehlen bereitgestellt werden, haben sie Vorrang vor den Maschinenprofilwerten dieser Eigenschaften.
  • Serviceangebot
  • Netzwerke
  • Sicherheitsgruppen
  • Mandantentyp
Hinweis:
Wenn das Serviceangebot nicht in der Startvorlage des Maschinenprofils oder als Parameter im New-ProvScheme-Befehl bereitgestellt wird, erhalten Sie eine entsprechende Fehlermeldung.
So erstellen Sie einen Katalog unter Verwendung der 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
  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" `
  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"
  6. Registrieren Sie das Bereitstellungsschema als Brokerkatalog. Zum Beispiel:
    New-BrokerCatalog -Name "MPLT1" `
    -AllocationType Random `
    -Description "Machine profile catalog" `
    -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
    -ProvisioningType Mcs `
    -SessionSupport MultiSession `
    -PersistUserChanges Discard
  7. Schließen Sie die Katalogerstellung ab. Weitere Informationen finden Sie unter Citrix PowerShell SDK
Sie können auch die Eingabe eines Maschinenprofilkatalogs von einer VM zu einer Startvorlagenversion und von einer Startvorlagenversion zu einer VM aktualisieren. Zum Beispiel:
  • So aktualisieren Sie die Eingabe eines Maschinenprofilkatalogs von einer VM auf eine Startvorlagenversion:
    Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
    -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
  • So aktualisieren Sie die Eingabe eines Maschinenprofilkatalogs von einer Startvorlagenversion auf eine VM:
    Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
    -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"

Betriebssystem- und ID-Datenträger verschlüsseln

Sie können persistente und nicht-persistente Kataloge von VMs mit AWS KMS-Schlüsseln (kundenverwalteter Schlüssel und AWS-verwalteter Schlüssel) erstellen, die zur Verschlüsselung von OS-Datenträgern und Identitätsdatenträgern verwendet werden können.
  • Von AWS verwaltete Schlüssel werden jährlich automatisch rotiert.
  • Vom Kunden verwaltete Schlüssel sind für die automatische Rotation optional und können manuell verwaltet werden.
Weitere Informationen zu KMS-Schlüsseln finden Sie in den folgenden AWS-Dokumenten:
Für die Verschlüsselung von Betriebssystem- und ID-Datenträgern konfigurieren Sie eine der folgenden Optionen:
  • Verwenden Sie ein verschlüsseltes Master-Image (z. B. ein AMI, das aus einer Instanz oder einem Snapshot erstellt wurde, der ein mit einem KMS-Schlüssel verschlüsseltes EBS-Root-Volume enthält).
  • Verwenden Sie eine Maschinenprofilquelle (VM oder Startvorlage), die ein verschlüsseltes EBS-Root-Volume enthält.

Einschränkungen

Beachten Sie die folgenden Einschränkungen:
  • MCS unterstützt derzeit nur eine Festplatte auf dem Master-Image-AMI.
  • Sie können vorhandene unverschlüsselte EBS-Volumes oder Snapshots nicht direkt verschlüsseln oder den KMS-Schlüssel eines vorhandenen verschlüsselten Volumes ändern. Dazu müssen Sie:
    1. Erstellen Sie einen neuen Snapshot dieses Volumes.
    2. Erstellen Sie ein neues Volume aus diesem Snapshot.
    3. Verschlüsseln Sie das neue Volume.
Siehe die folgenden AWS-Dokumente:

Katalog mit Festplattenverschlüsselung erstellen

Sie können einen MCS-Maschinenkatalog mit Festplattenverschlüsselung erstellen, indem Sie Folgendes verwenden:
  • Master-Image
  • Maschinenprofil
Überlegungen bei der Verwendung von Maschinenprofil-Eingaben für die Festplattenverschlüsselung:
  • Der KMS-Schlüssel der Maschinenprofil-Eingabe hat Vorrang vor dem KMS-Schlüssel des Master-Images.
  • Wenn keine Maschinenprofil-Eingabe bereitgestellt wird, wird der KMS-Schlüssel des Master-Image-AMI verwendet, um die Festplatten der Katalog-VMs zu verschlüsseln.
  • Wenn das Maschinenprofil Block Device Mappings enthält, müssen die im Master-Image-Template (AMI) und im Maschinenprofil vorhandenen Block-Geräte übereinstimmen. Wenn beispielsweise das AMI ein Gerät auf /dev/sda1 definiert hat, muss das Maschinenprofil auch ein Gerät auf /dev/sda1 definiert haben.
  • Wenn kein Schlüssel in der Maschinenprofilquelle vorhanden ist und das Master-Image unverschlüsselt ist, werden die Festplatten der Katalog-VMs nicht verschlüsselt.
  • Wenn das Master-Image verschlüsselt ist, muss eine Maschinenprofil-Quell-VM oder Startvorlage über ein verschlüsseltes Root-Volume verfügen, um als gültige Eingabe zu gelten.

Vorhandenen Katalog ändern

Sie können einen vorhandenen Katalog mit Set-ProvScheme ändern, um Folgendes zu haben:
  • Eine Maschinenprofileingabe mit einem Volume, das einen neuen KMS-Schlüssel enthält.
  • Ein Master-Image-Template-AMI, das mit einem neuen KMS-Schlüssel verschlüsselt ist.

Wichtige Überlegungen

  • Die Volumes neuer VMs, die dem Katalog hinzugefügt werden, werden mit dem neuen KMS-Schlüssel verschlüsselt.
  • Um die Verschlüsselungseinstellungen zu aktualisieren, wenn ein vorhandenes Maschinenprofil vorliegt, führen Sie Set-ProvScheme mit einem neuen Maschinenprofil aus.
  • Sie können einen vorhandenen Katalog nicht von verschlüsselten Volumes zu unverschlüsselten Volumes ändern. Sie können kein Image-Update von einem verschlüsselten Master-AMI zu einem unverschlüsselten Master-AMI durchführen.

VM-Instanzen filtern

Eine AWS EC2-Instanz, die Sie als Maschinenprofil-VM verwenden, muss kompatibel sein, damit der Maschinenkatalog korrekt erstellt und funktioniert. Um die AWS EC2-Instanzen aufzulisten, die als Eingabe-VMs für das Maschinenprofil 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 danach (oder davor, wenn ForwardDirection false ist) zurück, jedoch nicht das in ContinuationToken angegebene Element.
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
  • 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
  • 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
  • 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
Filtern:
Die folgenden zusätzlichen optionalen Parameter werden zum Filtern 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
  • -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
    Hinweis:
    Zwei Tag-Werte werden unterstützt. Der Tag-Wert Nicht getaggt stimmt mit Elementen überein, die das angegebene Tag nicht in ihrer Tag-Liste haben. Der Tag-Wert Alle Werte stimmt mit Elementen überein, 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
Filtern nach dem AdditionalData-Parameter:
Der AdditionalData Filterparameter listet Vorlagen oder VMs basierend auf ihrer Kapazität, ihrem Serviceangebot oder jeder Eigenschaft auf, die in AdditionalData enthalten ist. Zum Beispiel:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
Sie können auch einen -Warn Parameter hinzufügen, um die inkompatiblen VMs anzuzeigen. Die VMs werden mit einem AdditionalData Feld namens Warnung aufgenommen. Zum Beispiel:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData

Nächste Schritte

Weitere Informationen