AWS-Katalog erstellen
Unter Maschinenkataloge erstellen werden die Assistenten zum Erstellen eines Maschinenkatalogs beschrieben. Die folgenden Informationen beziehen sich speziell auf AWS-Virtualisierungsumgebungen.
Hinweis:
Bevor Sie einen AWS-Katalog erstellen, müssen Sie eine Verbindung zu AWS hergestellt haben. Siehe Verbindung zu AWS.
Netzwerkeinstellung während der Imagevorbereitung
Während der Imagevorbereitung wird eine virtuelle Vorbereitungsmaschine (Vorbereitungs-VM) basierend auf der ursprünglichen VM erstellt. Diese Vorbereitungs-VM ist vom Netzwerk getrennt. Zum Trennen des Netzwerks von der Vorbereitungs-VM wird eine Netzwerksicherheitsgruppe erstellt, um den gesamten eingehenden und ausgehenden Datenverkehr zu blockieren. Diese Netzwerksicherheitsgruppe bleibt bestehen und wird wiederverwendet. Der Name der Netzwerksicherheitsgruppe lautet Citrix.XenDesktop.IsolationGroup-GUID
, wobei die GUID nach dem Zufallsprinzip generiert wird.
AWS-Tenancy
AWS bietet die folgenden Tenancy-Optionen an: Freigegeben (Standardoption) und Dediziert. Bei einer freigegebenen Tenancy können sich die Amazon EC2-Instanzen mehrerer Kunden auf derselben physischen Hardware befinden. Bei der dedizierten Tenancy ist die Hardware zur Ausführung der EC2-Instanzen und anderer, vom Kunden entwickelter Instanzen nur einem Kunden vorbehalten. Sie wird nicht von anderen Kunden verwendet.
Sie können MCS verwenden, um dedizierte AWS-Hosts über die Schnittstelle für die vollständige Konfiguration oder PowerShell bereitzustellen.
Konfigurieren der dedizierten AWS-Hostmandantenschaft über die Schnittstelle für die vollständige Konfiguration
Wenn Sie mit MCS Kataloge zur Bereitstellung von Maschinen in AWS erstellen, werden auf der Seite Maschinenkatalogerstellung > Sicherheit die folgenden Optionen angezeigt:
-
Freigegebene Hardware verwenden: Diese Einstellung ist für die meisten Bereitstellungen geeignet. Mehrere Kunden teilen sich Hardware, ohne jedoch miteinander zu interagieren. Die Verwendung gemeinsam genutzter Hardware ist die kostengünstigste Amazon EC2-Option.
-
Dedizierten Host verwenden: Ein dedizierter Amazon EC2-Host ist ein physischer Server mit EC2-Instanzkapazität, der vollständig dediziert ist und die Verwendung vorhandener Socket- oder VM-Softwarelizenzen gestattet. Für dedizierte Hosts gilt eine voreingestellte Nutzung basierend auf dem Instanztyp. Ein einzelner dedizierter Host des Instanztyps C4 Large ist beispielsweise auf die Ausführung von 16 Instanzen beschränkt. Weitere Informationen finden Sie auf der AWS-Website.
Voraussetzungen für die Bereitstellung auf AWS-Hosts:
- Ein importiertes Bring Your Own License-Image (AMI). Mit dedizierten Hosts können Sie Ihre vorhandenen Lizenzen verwenden und verwalten.
- Eine Zuordnung dedizierter Hosts mit ausreichender Nutzungskapazität.
- Aktivierung von Automatische Platzierung.
Diese Einstellung eignet sich für Bereitstellungen mit Lizenzbeschränkungen oder Sicherheitsanforderungen, die die Verwendung eines dedizierten Hosts erfordern. Ein dedizierter Host wird ausschließlich für Sie verwendet und nach Stunden in Rechnung gestellt. Bei einem solchen Host können Sie ohne zusätzliche Kosten so viele EC2-Instanzen einrichten, wie der Host zulässt.
Alternativ können Sie dedizierte AWS-Hosts über PowerShell bereitstellen. Verwenden Sie dazu das cmdlet
New-ProvScheme
mit dem ParameterTenancyType
aufHost
. Weitere Informationen finden Sie in der Citrix Dokumentation für Entwickler. -
Dedizierte Instanz verwenden Diese Einstellung ist für Bereitstellungen geeignet, die bestimmten Sicherheitsanforderungen oder rechtlichen Bestimmungen genügen müssen. Bei einer dedizierten Instanz profitieren Sie von der Trennung des Hosts von dem anderer AWS-Kunden, zahlen aber nicht für den gesamten Host. Sie müssen sich keine Gedanken um die Kapazität des Hosts machen, für die Instanzen wird jedoch eine höhere Gebühr berechnet.
Dedizierte AWS-Hostmandanten mit PowerShell konfigurieren
Sie können einen Katalog mit Maschinen erstellen, deren Hostmandanten über PowerShell definiert wird.
Ein dedizierter Amazon [EC2]-Host ist ein physischer Server mit [EC2]-Instanzkapazität, der vollständig dediziert ist und die Verwendung vorhandener Socket- oder VM-Softwarelizenzen gestattet.
Für dedizierte Hosts gilt eine voreingestellte Nutzung basierend auf dem Instanztyp. Ein einzelner dedizierter Host des Instanztyps C4 Large ist beispielsweise auf die Ausführung von 16 Instanzen beschränkt. Weitere Informationen finden Sie auf der AWS-Website.
Voraussetzungen für die Bereitstellung auf AWS-Hosts:
- Ein importiertes Bring Your Own License-Image (AMI). Mit dedizierten Hosts können Sie Ihre vorhandenen Lizenzen verwenden und verwalten.
- Eine Zuordnung dedizierter Hosts mit ausreichender Nutzungskapazität.
- Aktiviertes Auto-Placement.
Verwenden Sie zur Bereitstellung auf einem dedizierten Host in AWS mit PowerShell das Cmdlet New-ProvScheme mit dem auf Host festgelegten Parameter “TenancyType”.
Weitere Informationen finden Sie in der Citrix Dokumentation für Entwickler.
AWS-Instanzeigenschaft erfassen
Wenn Sie einen Katalog für die Bereitstellung von Maschinen über Maschinenerstellungsdienste (MCS) in AWS erstellen, wählen Sie ein AMI (Amazon Machine Image) als Master-/Gold-Image des Katalogs. Von diesem AMI verwendet MCS einen Snapshot des Datenträgers. In früheren Versionen mussten Rollen oder Tags auf Maschinen individuell über die die AWS-Konsole festgelegt werden. Diese Funktion ist standardmäßig aktiviert.
Tipp:
Zur Verwendung der Erfassung der AWS-Instanzeigenschaft benötigen Sie eine VM, die dem AMI zugeordnet ist.
Zur Verbesserung dieses Prozesses liest MCS Eigenschaften aus der Instanz, aus der das AMI stammt, und wendet die IAM-Rolle und -Tags (Identity and Access Management) der Maschine auf die für einen bestimmten Katalog bereitgestellten Maschinen an. Wenn Sie dieses optionale Feature verwenden, findet der Katalogerstellungsprozess die ausgewählte AMI-Quellinstanz und liest einen begrenzten Satz von Eigenschaften. Diese Eigenschaften werden dann in einer AWS-Startvorlage gespeichert, mit der Maschinen für den Katalog bereitgestellt werden. Alle Maschinen im Katalog erben die erfassten Instanzeigenschaften.
Erfasste Eigenschaften sind:
- IAM-Rollen — auf bereitgestellte Instanzen angewendet.
- Tags – auf bereitgestellte Instanzen, deren Datenträger und Netzwerkkarten angewendet. Die Tags werden auf flüchtige Citrix Ressourcen angewendet: S3-Bucket und -Objekte, Volume- und Workerressourcen sowie AMIs, Snapshots und Startvorlagen.
Tipp:
Das Tagging flüchtiger Citrix Ressourcen ist optional und kann über die benutzerdefinierte Eigenschaft
AwsOperationalResourcesTagging
konfiguriert werden. Um Tags erfolgreich anzuwenden und einen AWS-Katalog mit Tagging von Betriebsressourcen zu erstellen, löschen Sie nicht die EC2-Instanz, die zum Erstellen des AMI-Images verwendet wurde.
AWS-Instanzeigenschaft erfassen
Sie können dieses Feature über die Spezifizierung der benutzerdefinierten Eigenschaft AwsCaptureInstanceProperties
beim Erstellen eines Provisioningschemas für eine AWS-Hostingverbindung nutzen:
New-ProvScheme -CustomProperties “AwsCaptureInstanceProperties,true” …<standard provscheme parameters
Weitere Informationen finden Sie in der Citrix Dokumentation für Entwickler.
Hinweis:
AwsCaptureInstanceProperties
ist veraltet.
AWS-Instanzeigenschaften anwenden und Betriebsressourcen in der Oberfläche “Vollständige Konfiguration” taggen
Wenn Sie einen Katalog zum Bereitstellen von Maschinen in AWS über die Maschinenerstellungsdienste erstellen, können Sie festlegen, ob Sie auf diese Maschinen die IAM-Rolle und Tag-Eigenschaften anwenden. Außerdem können Sie festlegen, ob Sie Maschinen-Tags auf Betriebsressourcen anwenden. Die folgenden zwei Optionen sind verfügbar:
-
Maschinenvorlageneigenschaften auf virtuelle Maschinen anwenden
- Steuert, ob die IAM-Rolle und die Tag-Eigenschaften, die der ausgewählten Maschinenvorlage zugeordnet sind, auf virtuelle Maschinen in diesem Katalog angewendet werden.
-
Maschinen-Tags auf Betriebsressourcen anwenden
- Steuert, ob Maschinen-Tags auf jedes Element in der AWS-Umgebung angewendet werden, das das Provisioning von Maschinen ermöglicht. Betriebsressourcen werden bei der Katalogerstellung als Nebenprodukte erstellt. Sie umfassen temporäre und persistente Ressourcen, zum Beispiel die Vorbereitungs-VM-Instanz und AMI.
AWS-Betriebsressource taggen
Ein Amazon Machine Image (AMI) ist eine virtuelle Appliance, die zum Erstellen einer virtuellen Maschine in der Amazon Cloud-Umgebung EC2 verwendet wird. Sie verwenden ein AMI, um Dienste bereitzustellen, die die EC2-Umgebung verwenden. Wenn Sie einen Katalog für die Bereitstellung von Maschinen über MCS für AWS erstellen, wählen Sie ein AMI als Gold-Image des Katalogs.
Wichtig:
Das Erstellen von Katalogen durch Erfassen einer Instanzeigenschaft und einer Startvorlage ist für die Verwendung des Taggings von Betriebsressourcen erforderlich.
Um einen AWS-Katalog zu erstellen, müssen Sie zunächst ein AMI für die Instanz erstellen, die als Gold-Image fungieren soll. MCS liest die Tags dieser Instanz und fügt sie in die Startvorlage ein. Die Startvorlagen-Tags werden dann auf alle in der AWS-Umgebung erstellten Citrix Ressourcen angewendet:
- Virtuelle Maschinen
- VM-Datenträger
- VM-Netzwerkschnittstellen
- S3-Buckets
- S3-Objekte
- Startvorlagen
- AMIs
Betriebsressource taggen
Tagging von Ressourcen mit PowerShell:
- Öffnen Sie ein PowerShell-Fenster vom DDC-Host aus.
- Führen Sie den Befehl
asnp citrix
aus, um Citrix spezifische PowerShell-Module zu laden.
Verwenden Sie die neue benutzerdefinierte Eigenschaft AwsOperationalResourcesTagging
, um eine Ressource für eine bereitgestellte VM zu taggen. Eigenschaftssyntax:
New-ProvScheme -CustomProperties “AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true” …<standard provscheme parameters>
Katalog mithilfe eines Maschinenprofils erstellen
Wenn Sie ein Maschinenprofil auswählen, werden die Hardwareeigenschaften der Maschine zusammen mit den IAM-Rollen und -Tags erfasst. Das Maschinenprofil erfasst unter anderem folgende Eigenschaften:
- EBS-Volumeeigenschaften
- EC2-Typ
- EBS-optimiert
- Elastic Graphics
- Elastic Network Adapter (ENA)
Sie können die Version einer AWS EC2-Instanz (VM) oder einer AWS-Startvorlage als Maschinenprofileingabe verwenden.
Hinweis:
EBS-Volumeeigenschaften werden nur aus einem Maschinenprofil abgeleitet.
Wichtige Überlegungen
Wichtige Überlegungen bei der Erstellung eines MCS-Maschinenkatalogs:
- Wenn Sie die Parameter für die Maschinenhardware-Eigenschaft in den Befehlen
New-ProvScheme
undSet-ProvScheme
hinzufügen, überschreiben die in den Parametern angegebenen Werte die Werte im Maschinenprofil. - Wenn Sie
AwsCaptureInstanceProperties
auftrue
festlegen, die EigenschaftMachineProfile
jedoch nicht festlegen, werden nur IAM-Rollen und -Tags erfasst. -
Sie können
AwsCaptureInstanceProperties
undMachineProfile
nicht gleichzeitig festlegen.**Hinweis:
AwsCaptureInstanceProperties
ist veraltet. -
Sie müssen die Werte der folgenden Eigenschaften explizit angeben:
- TenancyType
- Sicherheitsgruppe
- NIC oder virtuelles Netzwerk
- Sie können
AwsOperationalResourcesTagging
nur aktivieren, wenn SieAwsCaptureInstanceProperties
aktivieren oder ein Maschinenprofil angeben.
Wichtige Überlegungen nach der Erstellung eines MCS-Maschinenkatalogs:
- Nur die neuen virtuellen Maschinen, die dem Katalog hinzugefügt wurden, sind von der Änderung betroffen.
- Ein Maschinenkatalog, der auf einem Maschinenprofil basiert, kann nicht in einen Maschinenkatalog geändert werden, der nicht auf einem Maschinenprofil basiert.
Erstellen eines Maschinenkatalogs unter Verwendung eines Maschinenprofils
Erstellen eines Maschinenkatalogs mithilfe eines Maschinenprofils:
- Öffnen Sie ein PowerShell-Fenster.
- Führen Sie
asnp citrix*
aus, um die Citrix-spezifischen PowerShell-Module zu laden. -
Erstellen Sie einen Identitätspool, falls noch nicht vorhanden. Beispiel:
New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric <!--NeedCopy-->
-
Führen Sie den Befehl New-ProvScheme aus. 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-->
- Schließen Sie das Erstellen des Katalogs ab. Weitere Informationen finden Sie unter Citrix PowerShell SDK.
Aktualisieren des Maschinenprofils in einem Katalog, der mit einem Maschinenprofil bereitgestellt wurde:
-
Führen Sie den Befehl
Set-ProvScheme
aus. 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 auch die Eingabe eines Maschinenprofilkatalogs von einer VM auf eine Startvorlagenversion und von einer Startvorlagenversion auf eine VM aktualisieren.
Auf der AWS EC2-Konsole können Sie die Instanzkonfigurationsangaben einer Startvorlage zusammen mit der Versionsnummer angeben. Wenn Sie beim Erstellen oder Aktualisieren eines Maschinenkatalogs die Startvorlagenversion als Maschinenprofileingabe angeben, werden die Eigenschaften aus dieser Startvorlagenversion auf die bereitgestellten VDA-VMs kopiert.
Die folgenden Eigenschaften können mithilfe der Maschinenprofileingabe 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 Eigenschaftswerten im Maschinenprofil.
- Dienstangebot
- Netzwerke
- Sicherheitsgruppen
- Mandantenmodell
Hinweis:
Wenn das Dienstangebot nicht in der Startvorlage für das Maschinenprofil oder als Parameter im Befehl
New-ProvScheme
angegeben ist, wird eine Fehlermeldung angezeigt.
Erstellen eines Katalog mit der Startvorlagenversion als Maschinenprofileingabe:
- Öffnen Sie ein PowerShell-Fenster.
- Führen Sie
asnp citrix*
aus, um die Citrix-spezifischen PowerShell-Module zu laden. -
Rufen Sie die Liste der Startvorlagenversionen einer Startvorlage auf. Beispiel:
XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath <!--NeedCopy-->
-
Erstellen Sie einen Identitätspool (falls nicht vorhanden). Beispiel:
New-AcctIdentityPool ` -IdentityPoolName "abc11" ` -NamingScheme "abc1-##" ` -NamingSchemeType Numeric ` -Domain "citrix-xxxxxx.local" ` -ZoneUid "xxxxxxxx" ` <!--NeedCopy-->
-
Erstellen Sie ein Provisioningschema mit einer Startvorlagenversion als Maschinenprofileingabe. 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 Parameter wie Dienstangebot, Sicherheitsgruppen, Mandantenmodell und Netzwerke auch überschreiben. 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-->
-
Registrieren Sie das Provisioningsschema als Brokerkatalog. Beispiel:
New-BrokerCatalog -Name "MPLT1" ` -AllocationType Random ` -Description "Machine profile catalog" ` -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx ` -ProvisioningType Mcs ` -SessionSupport MultiSession ` -PersistUserChanges Discard <!--NeedCopy-->
- Schließen Sie das Erstellen des Katalogs ab. Weitere Informationen finden Sie unter Citrix PowerShell SDK.
Sie können auch die Eingabe eines Maschinenprofilkatalogs von einer VM auf eine Startvorlagenversion und von einer Startvorlagenversion auf eine VM aktualisieren. Beispiel:
-
Aktualisieren der 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" <!--NeedCopy-->
-
Aktualisieren der 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" <!--NeedCopy-->
Katalog von VMs mit Elastic Graphics-Accelerator erstellen
Mithilfe eines Maschinenprofil-basierten Workflows können Sie einen Katalog von VMs erstellen, die mit einem Amazon Elastic Graphics-Accelerator aktiviert sind. Sie können eine VM oder eine Startvorlage als Maschinenprofileingabe verwenden.
Verfahren:
- Aktivieren Sie einen Elastic Graphics-Accelerators für eine VM oder Startvorlage. Informationen zur Aktivierung des Elastic Graphics-Accelerators finden Sie unter Arbeiten mit Elastic Graphics.
-
Überprüfen Sie den Typ des Elastic Graphic-Accelerators, der von der VM- bzw. Startvorlagenversion verwendet wird. Wenn der Schlüssel
ElasticGpuType
nicht in den zusätzlichen Daten enthalten ist, ist der Elastic Graphic-Accelerator für die VM bzw. Startvorlage nicht aktiviert.-
Beispiel für VM:
(Get-Item -LiteralPath 'XDHyp:\HostingUnits\abc-resources\us-eat-1a.availibilityzone\abcelastic (i-0584xxxxxab8b2206).vm').AdditionalData <!--NeedCopy-->
-
Beispiel für Startvorlage:
(Get-Item -LiteralPath 'XDHyp:\HostingUnits\abc-resources\ElasticGC (lt-015f531351188cd2e).launchtemplate\lt-015f531351188cd2e (1).launchtemplateversion).AdditionalData <!--NeedCopy-->
-
- Erstellen Sie einen MCS-Maschinenkatalog mit Maschinenprofilworkflow, indem Sie eine VM oder Startvorlage auswählen. Sie können den Maschinenkatalog mithilfe von PowerShell-Befehlen erstellen.
Hinweis:
Der Maschinenkatalog muss die Voraussetzungen für Elastic Graphics erfüllen, damit der Maschinenkatalog erstellt werden kann. Stellen Sie daher sicher, dass der EC2-Instance-Typ mit Elastic Graphics kompatibel ist. Weitere Informationen finden Sie unter Elastic Graphics-Grundlagen.
VM-Instanzen filtern
Eine AWS-VM-Instanz, die Sie als Maschinenprofil-VM verwenden, muss kompatibel sein, damit der Maschinenkatalog erstellt werden kann und ordnungsgemäß funktioniert. Zum Auflisten der AWS-VM-Instanzen, die als Eingabe-VMs für Maschinenprofile verwendet werden können, können Sie den Befehl Get-HypInventoryItem
verwenden. Mit dem Befehl kann der Bestand der auf einer Hostingeinheit verfügbaren virtuellen Maschinen paginiert und gefiltert werden.
Paginierung:
Get-HypInventoryItem unterstützt zwei Paginierungsmodi:
- Der Seitenmodus verwendet die Parameter
-MaxRecords
und-Skip
, um Gruppen 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 ab dem absoluten Anfang (oder absoluten Ende) der Liste im Hypervisor übersprungen werden sollen.
-
- Der Scrollmodus 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 den nächsten Satz oder den vorherigen Satz übereinstimmender Datensätze zurückzugeben. -
-ContinuationToken
: Gibt die Elemente unmittelbar danach zurück (oder davor, fallsForwardDirection
= false), jedoch ohne das inContinuationToken
angegebenen Element.
-
Beispiele der Paginierung:
-
Um einen einzelnen Datensatz mit der Maschinenvorlage mit dem niedrigsten Namen zurückzugeben. Das Feld
AdditionalData
enthältTotalItemsCount
undTotalFilteredItemsCount
:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template <!--NeedCopy-->
-
Ausgabe von 10 Datensätzen der Maschinenvorlage mit dem niedrigsten Namen:
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, beginnend mit der Maschinenvorlage, die dem
ContinuationToken
zugeordnet ist:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10 <!--NeedCopy-->
Filtern:
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 dasGet
-Ergebnis aufgenommen. 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 dasGet
-Ergebnis aufgenommen. 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 Wert Not Tagged entspricht Elementen, die das angegebene Tag nicht in ihrer Tag-Liste haben. Der Wert All Values entspricht Elementen, die das Tag haben, unabhängig von dessen Wert. Andernfalls gilt es nur als Übereinstimmung, wenn das Element das Tag hat und der Wert der Angabe im Filter entspricht.
-
-Id "ami-0a2d913927e0352f3"
: Wenn das AMI mit der angegebenen ID übereinstimmt, wird es in dasGet
-Ergebnis aufgenommen. Beispiel:Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx <!--NeedCopy-->
Filtern nach dem Parameter “AdditionalData”:
Der Filterparameter AdditionalData
listet Vorlagen oder VMs auf der Grundlage ihrer Funktionen, ihres Dienstangebots oder einer beliebigen Eigenschaft in “AdditionalData” auf. Beispiel:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->
Sie können auch einen Parameter -Warn
hinzufügen, um die nicht kompatiblen VMs anzugeben. Die VMs sind in einem AdditionalData
-Feld mit dem Namen Warning enthalten. Beispiel:
(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->
Ruhezustand von Instanzen
Beim Ruhezustand wird der In-Memory-Status der Instanz samt privater und elastischer IP-Adressen gespeichert, sodass Benutzer genau dort weitermachen kann, wo sie aufgehört haben.
Wenn eine Instanz in den Ruhezustand versetzt wird, schreibt sie ihren In-Memory-Status in eine Datei auf dem EBS-Stammvolume und fährt dann herunter. Ein Amazon EBS-Volume ist ein robuster Blockspeicher, den Sie an Ihre Instanzen anschließen können. Nachdem Sie ein Volume an eine Instanz angeschlossen haben, können Sie es wie eine physische Festplatte verwenden. Verschlüsseln Sie das EBS-Stammvolume der Instanz. Die Verschlüsselung gewährleistet einen angemessenen Schutz vertraulicher Daten, wenn sie aus dem Speicher in das EBS-Volume kopiert werden. Informationen zur EBS-Verschlüsselung finden Sie unter Amazon EBS encryption.
Es gelten folgende Einschränkungen für den unterstützten Ruhezustand von Instanzen:
- Instanzenspeicher (RAM) bis maximal 150 GB unterstützt
- UEFI-Startmodus wird nicht unterstützt
- Es werden nur Allzweck-SSD und Bereitgestellte IOPS-SSD als EBS-Volumetypen unterstützt.
Dies sind die Hostverbindungsfunktionen auf Hypervisor-Ebene:
- Hypervisors mit Suspend-Funktion: VMware, Citrix Hypervisor, Hyper-V und GCP
- Hypervisors ohne Suspend-Funktion: Nutanix, Azure und AWS
Hinweis:
- Die Suspend-Funktion umfasst alle Funktionen zum Anhalten und in den Ruhezustand versetzen.
- Für AWS wird die Suspend-Funktion auf Maschinenebene unterstützt, jedoch nicht auf Hypervisorebene.
VMs mit unterstütztem Ruhezustand erstellen
Erstellen von VMs mit unterstütztem Ruhezustand:
- Erstellen Sie eine Hostverbindung. Siehe Verbindung zu AWS.
- Starten Sie eine Instanz mit verschlüsseltem EBS-Stamm und aktivierter Eigenschaft Stop-Hibernate. Weitere Informationen zum Starten der Instanz, Verschlüsseln des EBS-Stammvolumes und Aktivieren des Ruhezustands finden Sie unter https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/launching-instance.html/. Verwenden Sie diese Instanz als Masterimage, um ein AMI zu erstellen.
-
Bereiten Sie das Masterimage vor:
- Installieren Sie einen VDA auf dem Masterimage. Citrix empfiehlt die Installation der neuesten Version, damit die neuesten Features verfügbar sind. Wird kein VDA auf dem Masterimage installiert, schlägt die Katalogerstellung fehl. Weitere Informationen zur Installation eines VDA finden Sie unter Installieren von VDAs.
- Fügen Sie das Masterimage der Domäne hinzu, zu der die Anwendungen und Desktops gehören. Stellen Sie sicher, dass das Masterimage auf dem Host verfügbar ist, auf dem die Maschinen erstellt werden.
- Erstellen Sie ein AMI aus dieser Instanz. Informationen zum Erstellen eines AMI aus einer Instanz finden Sie unter Create an AMI from an Amazon EC2 Instance.
-
Erstellen Sie mit dem Befehl
New-ProvScheme
einen Maschinenkatalog. Legen Sie die benutzerdefinierte EigenschaftAwsCaptureInstanceProperties
auf True fest. Informationen zum Aktivieren von AWS-Instanzeigenschaften in der Benutzeroberfläche “Vollständige Konfiguration” finden Sie unter Anwenden von AWS-Instanzeigenschaften und Tagging von Betriebsressourcen in der Benutzeroberfläche “Vollständige Konfiguration”.New-ProvScheme -AdminAddress "xxx" -CleanOnBoot -CustomProperties "AwsCaptureInstanceProperties,true;" -HostingUnitName "xxx" -IdentityPoolName $catalog_name -InitialBatchSizeHint 1 -MasterImageVM "xyz.template" -NetworkMapping @{"0"="XDHyp:\HostingUnits\MyConn\us-east-2a.availabilityzone\10.0.0.0``/24 (vpc-0f1771e45671aedcd).network"} -ProvisioningSchemeName $catalog_name -RunAsynchronously -Scope @() -SecurityGroup @("xxx") -ServiceOffering "xxx" <!--NeedCopy-->
Hinweise zum Erstellen eines Maschinenkatalogs mithilfe von PowerShell-Befehlen finden Sie unter https://developer-docs.citrix.com/projects/citrix-daas-sdk/en/latest/.
VMs, die in den Ruhezustand versetzt werden können, werden erstellt, wenn Folgendes gilt:
- Sie wählen ein AMI aus, das aus einem Masterimage mit aktivierter Eigenschaft Stop-Hibernate erstellt wurde.
- Die Master-VM ist domänengebunden und hat einen installierten VDA.
- Sie wählen die richtige VM-Größe (Dienstangebot), die den Ruhezustand bewältigen kann.
Der Befehl New-ProvScheme schlägt fehl und es wird eine Fehlermeldung angezeigt, wenn Folgendes gilt:
- Die Ruhezustandsfunktion ist für die Master-VM aktiviert, das Dienstangebot kann den Ruhezustand jedoch nicht verarbeiten.
- Die Master-VM ist nicht domänengebunden und hat keinen installierten VDA.
Ruhezustandsstatus von Dienstangeboten und AMI
Führen Sie die folgenden Befehle aus, um den Ruhezustandsstatus von Dienstangeboten und AMI (Vorlagen) abzurufen:
Get-HypConfigurationObjectForItem 'XDHyp:\HostingUnits\MyConn\WIN2016-ADDC-2021.09.10.145334-a1968709-10c4-47d5-9642-21e743159a7b (ami-0e6c5b33a52d2a6b6).template'
Get-HypConfigurationObjectForItem 'XDHyp:\HostingUnits\MyConn\R6i Sixteen Extra Large Instance.serviceoffering'
Dienstangebot eines bestehenden Provisioningschemas mit unterstütztem Ruhezustand aktivieren
-
Führen Sie den Befehl
Set-ProvScheme
aus. Beispiel:Set-ProvScheme -ProvisioningSchemeName <String> -ServiceOffering <String> <!--NeedCopy-->
Das System zeigt eine Ausnahmemeldung an, wenn das Dienstangebot nicht kompatibel ist.
Update eines Maschinenkatalogs, der den Ruhezustand unterstützt
Wenn Sie versuchen, einen vorhandenen Maschinenkatalog durch einen Maschinenkatalog zu ersetzen, der den Ruhezustand nicht unterstützt, schlägt das Update fehl und es wird eine Fehlermeldung angezeigt.
Energieverwaltung von VMs im Ruhezustand
Sie können die folgenden Energieverwaltungsvorgänge auf VMs im Ruhezustand ausführen:
- Sie können eine ausgeführte VM anhalten.
- Sie können eine angehaltene VM fortsetzen.
- Sie können eine angehaltene VM neu starten.
Zur Anzeige der Energieverwaltungsoptionen klicken Sie in der Benutzeroberfläche Verwalten > Vollständige Konfiguration mit der rechten Maustaste auf die im Ruhezustand befindlichen VMs.
Sie können auch für jede VM je nach gewählter Operation den Energiezustand als Anhalten bzw. Angehalten anzeigen.
So geht es weiter
- Wenn Sie den ersten Katalog erstellen, werden Sie zum Erstellen einer Bereitstellungsgruppe geleitet.
- Informationen zum gesamten Konfigurationsprozess finden Sie unter Planen und Erstellen einer Bereitstellung.
- Informationen zur Verwaltung von Katalogen finden Sie unter Maschinenkataloge verwalten und AWS-Katalog verwalten.
Weitere Informationen
In diesem Artikel
- Netzwerkeinstellung während der Imagevorbereitung
- AWS-Tenancy
- AWS-Instanzeigenschaft erfassen
- AWS-Instanzeigenschaften anwenden und Betriebsressourcen in der Oberfläche “Vollständige Konfiguration” taggen
- AWS-Betriebsressource taggen
- Katalog mithilfe eines Maschinenprofils erstellen
- Katalog von VMs mit Elastic Graphics-Accelerator erstellen
- VM-Instanzen filtern
- Ruhezustand von Instanzen
- So geht es weiter
- Weitere Informationen