Produktdokumentation
Citrix DaaS™
PDF anzeigen

Erstellen eines vorbereiteten Images für Amazon WorkSpaces Core Managed Instances

March 25, 2026
Beitrag von: 
C

Erstellen Sie vorbereitete Images, um einen MCS-Maschinenkatalog zu erstellen. Sie können vorbereitete Images erstellen mit:

Wichtige Schritte

  1. Erstellen Sie die Image-Definition und die anfänglichen Image-Versionen.
  2. Erstellen Sie Image-Versionen aus der anfänglichen Image-Version.

Verwenden von Studio

Erstellen einer Image-Definition und einer anfänglichen Image-Version

Gehen Sie wie folgt vor, um eine Image-Definition und die anfängliche Image-Version zu erstellen:

  1. Navigieren Sie in Studio zum Knoten Images und klicken Sie auf Create Image Definition (Image-Definition erstellen). Klicken Sie auf der Seite Introduction (Einführung) auf Next (Weiter).
  2. Geben Sie auf der Seite Image Definition (Image-Definition) den OS type (Betriebssystemtyp) und den Session type (Sitzungstyp) für die Image-Definition an.

  3. Wählen Sie auf der Seite Image (Image) Resources (Ressourcen) (nur die für die festgelegte Verbindung anwendbaren Ressourcen werden aufgelistet), ein Master-Image, das als Vorlage zum Erstellen der Image-Version verwendet werden soll, und ein Maschinenprofil zum Erfassen von Hardwareeigenschaften aus. Wählen Sie ein Maschinenprofil aus, um Hardwareeigenschaften von einer VM-Instanz oder einer Startvorlagenversion zu erfassen.

    Hinweis:

    • Vergewissern Sie sich vor der Auswahl eines Images, dass auf dem Master-Image VDA 2311 oder höher installiert ist und der MCSIO-Treiber auf dem VDA installiert ist.
    • Nur der Instance Metadata Service (IMDS) V2 wird unterstützt, nicht IMDS V1. Weitere Informationen finden Sie unter How Instance Metadata Service Version 2 works.
  4. Wählen Sie auf der Seite Machine Specification (Maschinenspezifikation) eine Maschinengröße aus. Die Maschinengröße des Maschinenprofils (auf der Seite Image ausgewählt) ist standardmäßig ausgewählt.
  5. Wählen oder fügen Sie auf der Seite NICs (Netzwerkkarten) Netzwerkkarten für das Vorbereitungs-Image hinzu. Wählen Sie für jede Netzwerkkarte ein zugehöriges VPC-Subnetz aus.
  6. Geben Sie auf der Seite Version Description (Versionsbeschreibung) eine Beschreibung für die erstellte anfängliche Image-Version ein.
  7. Überprüfen Sie auf der Seite Summary (Zusammenfassung) die Details der Image-Definition und der erstellten anfänglichen Image-Version. Geben Sie einen Namen und eine Beschreibung für die Image-Definition ein. Klicken Sie auf Finish (Fertig stellen).

Erstellen von Image-Versionen

Image-Versionen ermöglichen die Verwaltung verschiedener Iterationen oder Updates eines bestimmten Images. Diese Funktionalität ermöglicht es Ihnen, mehrere Versionen eines Images für verschiedene Zwecke zu verwalten.

Gehen Sie wie folgt vor, um Image-Versionen aus der anfänglichen Image-Version zu erstellen:

Hinweis:

Die Hosting-Einheit aller Image-Versionen muss dieselbe sein.

  1. Navigieren Sie zum Knoten Images, wählen Sie eine Image-Version oder eine Image-Definition aus und klicken Sie auf Create Image Version (Image-Version erstellen).
  2. Auf der Seite Image definition (Image-Definition) können Sie die Hosting-Einheit ändern und das Master-Image sowie das Maschinenprofil für diese Image-Version neu auswählen.
  3. Wenn die Konfiguration der Image-Version von der anfänglich konfigurierten Image-Version abweichen soll, konfigurieren Sie die Einstellungen auf den Seiten Machine Specification (Maschinenspezifikation) und NICs (Netzwerkkarten) des Dialogfelds Create Image Version (Image-Version erstellen).
  4. Fügen Sie eine Beschreibung für die Image-Version hinzu. Klicken Sie auf Finish (Fertig stellen).

Hinweis:

Wenn die Erstellung der Image-Version aus irgendeinem Grund fehlschlägt, bietet die Registerkarte Troubleshoot (Fehlerbehebung) unten eine Option zum Retry (Wiederholen).

Verwenden von PowerShell

Die detaillierten PowerShell-Befehle zum Erstellen einer Spezifikation für eine vorbereitete Image-Version lauten wie folgt:

  1. Überprüfen Sie die verfügbaren Namen der Image-Definitionen mit dem Befehl Test-ProvImageDefinitionNameAvailable. Beispiel:

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Erstellen Sie eine Image-Definition mit dem Befehl New-ProvImageDefinition. Beispiel:

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Erstellen Sie eine neue Konfiguration für die Image-Definition in der angegebenen Hosting-Verbindung mit dem Befehl Add-ProvImageDefinitionConnection.

    Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
<!--NeedCopy-->

  4. Erstellen Sie eine Image-Version mit dem Befehl New-ProvImageVersion. Beispiel:

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  5. Fügen Sie der Image-Version eine Master-Image-Versionsspezifikation mit dem Befehl Add-ProvImageVersionSpec hinzu. Beispiel:

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"
<!--NeedCopy-->

    Hinweis:

    Sie können nur eine Master-Image-Versionsspezifikation zu einer Image-Version für eine Hosting-Einheit hinzufügen.

  6. Erstellen Sie eine Spezifikation für eine vorbereitete Image-Version aus der Master-Image-Versionsspezifikation mit dem Befehl New-ProvImageVersionSpec. Der Parameter SourceImageVersionSpecUid wird vom Befehl Add-ProvImageVersionSpec abgeleitet. Beispiel:

    New-ProvImageVersionSpec
-SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
-MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
<!--NeedCopy-->

Beispiel für den vollständigen Satz von PowerShell-Befehlen zum Erstellen einer Image-Definition, einer Image-Version und einer Spezifikation für eine vorbereitete Image-Version:

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

Hinweis:

  • Alle Image-Versionsspezifikationen in einer Image-Definition müssen zur selben Hosting-Einheit gehören.
  • Eine Image-Version kann nur eine Master-Image-Versionsspezifikation und eine vorbereitete Image-Versionsspezifikation haben.
  • Alle Image-Versionsspezifikationen müssen ein Maschinenprofil haben.

Vorbereitete Images über Verfügbarkeitszonen und Regionen hinweg teilen

Sie können jetzt ein einzelnes vorbereitetes Image über verschiedene Verfügbarkeitszonen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, innerhalb derselben AWS-Region oder in verschiedenen Regionen für Ihre Amazon WorkSpaces Core Managed Instances teilen. Dadurch können Sie ein vorbereitetes Image verwenden, um MCS-Maschinenkataloge in verschiedenen Verfügbarkeitszonen und Regionen zu erstellen und zu aktualisieren. Beim Teilen über verschiedene AZs in verschiedenen Regionen wird die vorbereitete Image-Version von der ursprünglichen Region in die Zielregionen kopiert.

Sie können ein einzelnes vorbereitetes Image pflegen und es verwenden, um Maschinenkataloge über mehrere Verfügbarkeitszonen und Regionen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, zu erstellen und zu aktualisieren. Dies reduziert Ihren Verwaltungsaufwand für Images erheblich, gewährleistet Konsistenz über Bereitstellungen hinweg und optimiert den Bereitstellungsprozess. Sie können auch bestehende Maschinenkataloge nahtlos mit vorbereiteten Images aus einer anderen Verfügbarkeitszone oder Region aktualisieren.

Anwendungsfälle

  • Zentralisierte Image-Verwaltung: Sie erstellen ein vorbereitetes Image in einer Verfügbarkeitszone (zum Beispiel us-east-1a). Sie können dieses Image dann für andere Verfügbarkeitszonen wie us-east-1b innerhalb derselben AWS-Region us-east-1 oder us-west-1a in einer anderen Region us-west-1 freigeben. Dies ermöglicht es einem einzigen Image, mehrere Hosting-Einheiten zu bedienen und vereinfacht die Wartung für Sie.
  • Effiziente Katalogerstellung und -aktualisierung: Sie können ein in AZ 1 (zum Beispiel us-east-1a) erstelltes vorbereitetes Image verwenden, um neue Kataloge in AZ 1 zu erstellen. Nachdem Sie dieses Image für AZ 2 (zum Beispiel us-east-1b) freigegeben haben, können Sie das freigegebene Image in AZ 2 verwenden, um Kataloge in AZ 2 zu erstellen und zu aktualisieren.
  • Bereitstellungen über Hosting-Einheiten und Hosting-Verbindungen hinweg: Wenn Ihre Umgebung mehrere Hosting-Einheiten unter derselben oder verschiedenen AWS-Regionen umfasst, können Sie vorbereitete Images effizient zwischen diesen Hosting-Einheiten teilen.

Einschränkungen

  • Teilen innerhalb desselben AWS-Kontos: In der aktuellen Implementierung können Sie nicht über verschiedene AWS-Konten hinweg teilen.

Wichtige Überlegungen

  • Löschreihenfolge: Um eine ursprüngliche vorbereitete Image-Versionsspezifikation zu löschen, müssen Sie zuerst alle ihre freigegebenen Image-Versionsspezifikationen löschen. Alternativ müssen Sie die ursprünglichen und freigegebenen Spezifikationen gleichzeitig löschen.
  • Image-Versionsabhängigkeit: Wenn Sie eine Image-Version entfernen, müssen Sie zuerst alle Freigabekonfigurationen entfernen, die von dieser spezifischen Image-Version abhängen. Kataloge, die Sie aus dem ursprünglichen (nicht freigegebenen) Image erstellt haben, können intakt bleiben.
  • Katalog-Abwärtskompatibilität: Sie können bestehende Maschinenkataloge aktualisieren, die Sie vor der Einführung dieser Funktion bereitgestellt haben. Verwenden Sie vorbereitete Images, die Sie in einer anderen Verfügbarkeitszone oder Region erstellt haben, als der, in der Sie den Katalog ursprünglich bereitgestellt haben.
  • Vollständige Löschung: Wenn Sie ein vorbereitetes Image löschen, können Sie es in keiner Verfügbarkeitszone mehr verwenden, in der Sie es freigegeben oder ursprünglich erstellt haben. Darüber hinaus kann eine vorbereitete Image-Version erst gelöscht werden, wenn alle Kataloge, die an die vorbereitete Image-Version gebunden sind, zuerst gelöscht wurden.

Voraussetzungen

Bevor Sie diese Funktion konfigurieren oder verwenden, stellen Sie sicher, dass Sie die folgenden Bedingungen erfüllen:

  • Ihre Umgebung muss eine Amazon WorkSpaces Core Managed Instances-Umgebung sein.
  • Sie müssen mehrere Hosting-Einheiten (jede kann an verschiedene Verfügbarkeitszonen gebunden sein) und Host-Verbindungen (jede kann an eine andere Region gebunden sein) unter demselben AWS-Konto konfigurieren.

Konfiguration über die Studio-Benutzeroberfläche

Sie können vorbereitete Images über Verfügbarkeitszonen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, über die Studio-Benutzeroberfläche teilen.

So teilen Sie ein vorbereitetes Image

  1. Navigieren Sie im Studio zum Knoten Images und wählen Sie die vorbereitete Image-Version aus, die Sie mit anderen Verfügbarkeitszonen teilen möchten.
  2. Wählen Sie in der oberen Navigationsleiste Manage Image Share (Image-Freigabe verwalten) aus, um die Image-Freigabe für die ausgewählte Image-Version zu verwalten.
  3. Wählen Sie auf der Seite Manage Image Share (Image-Freigabe verwalten) eine oder mehrere Ressourcen aus, mit denen Sie die Image-Version teilen möchten. Die Ressourcen können sich in anderen Verfügbarkeitszonen befinden als die der ursprünglichen Image-Version.
  4. Klicken Sie auf Save (Speichern), um die Image-Version in den Ressourcen über andere Verfügbarkeitszonen hinweg zu teilen. Die Image-Version wird so aktualisiert, dass sie über die verschiedenen von Ihnen ausgewählten Ressourcen hinweg geteilt wird. Verwenden Sie nach Abschluss die Image-Version, um Kataloge in den Verfügbarkeitszonen zu erstellen, in denen die Image-Version geteilt wird.

So entfernen Sie die Freigabe eines vorbereiteten Images

  1. Wählen Sie im Knoten Images des Studios die vorbereitete Image-Version aus, deren Freigabe Sie aufheben möchten.
  2. Wählen Sie in der oberen Navigationsleiste Manage Image Share (Image-Freigabe verwalten) aus, um die Image-Freigabe für die ausgewählte Image-Version zu verwalten.

  3. Deaktivieren Sie die Kontrollkästchen für eine oder mehrere Ressourcen (Verfügbarkeitszonen), mit denen Sie die Freigabe der Image-Version beenden möchten.

    Hinweis:

    Die Ressourcen dürfen keine Kataloge mehr enthalten, die mit der freigegebenen Image-Version verknüpft und aus dieser erstellt wurden. Alle Kataloge, die aus der zu entfernenden freigegebenen Image-Version erstellt wurden, müssen zuerst gelöscht werden.

  4. Klicken Sie auf Save (Speichern), um die Freigabe der Ressourcen über die deaktivierten Verfügbarkeitszonen hinweg aufzuheben. Die Image-Version wird so aktualisiert, dass sie in diesen Verfügbarkeitszonen nicht mehr geteilt wird.

Konfiguration über PowerShell

Alternativ können Sie vorbereitete Images über Verfügbarkeitszonen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, mithilfe von PowerShell-Befehlen teilen.

So teilen Sie ein vorbereitetes Image

  1. Stellen Sie sicher, dass Sie die ImageVersionSpecUid des vorbereiteten Images haben, das Sie teilen möchten. Sie können diese mit Get-ProvImageVersionSpec oder ähnlichen Get--Befehlen in PowerShell abrufen.
  2. Bestimmen Sie den HostingUnitName der Verfügbarkeitszone (kann dieselbe oder eine andere Region sein), in der Sie das vorbereitete Image verfügbar machen möchten. Dies ist der Name der Hosting-Einheit, die Sie für diese spezifische AZ konfiguriert haben.

  3. Führen Sie den Befehl Add-ProvImageVersionSpecHostingUnit aus: Verwenden Sie den folgenden PowerShell-Befehl. Ersetzen Sie <ImageVersionSpecUid> durch die Uid Ihres Images und <targetHostingUnitName> durch den Namen der Hosting-Einheit in der Zielverfügbarkeitszone, für die Sie die Image-Versionsspezifikation freigeben möchten:

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->
  4. Nach erfolgreicher Ausführung können Sie den Status des Images in der Studio-Benutzeroberfläche sehen, der anzeigt, dass Sie es mit der angegebenen Hosting-Einheit geteilt haben.

So entfernen Sie die Freigabe eines vorbereiteten Images

  1. Stellen Sie sicher, dass Sie die ImageVersionSpecUid des vorbereiteten Images haben, dessen Freigabe Sie aufheben möchten.
  2. Bestimmen Sie den HostingUnitName der Verfügbarkeitszone, aus der Sie das freigegebene Image entfernen möchten.

  3. Führen Sie den Befehl Remove-ProvImageVersionSpecHostingUnit aus: Verwenden Sie den folgenden PowerShell-Befehl. Ersetzen Sie <ImageVersionSpecUid> durch die Uid Ihres Images und <targetHostingUnitName> durch den Namen der Hosting-Einheit in der Zielverfügbarkeitszone, aus der Sie die Freigabe der Image-Versionsspezifikation entfernen möchten:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->

Nächste Schritte

Weitere Informationen

Erstellen eines vorbereiteten Images für Amazon WorkSpaces Core Managed Instances
March 25, 2026
Beitrag von: 
C
March 25, 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.