Produktdokumentation
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

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

June 5, 2026
Beitrag von: 
C

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

Wichtige Schritte

  1. Erstellen Sie die Imagestruktur und die anfänglichen Imageversionen.
  2. Erstellen Sie Imageversionen aus der anfänglichen Imageversion.

Web Studio verwenden

Erstellen einer Imagestruktur und einer anfänglichen Imageversion

Gehen Sie wie folgt vor, um eine Imagestruktur und die anfängliche Imageversion zu erstellen:

  1. Navigieren Sie in Web Studio zum Knoten Images und klicken Sie auf Create Image Definition. Klicken Sie auf der Seite Introduction auf Next.
  2. Geben Sie auf der Seite Image Definition den OS type und den Session type für die Imagestruktur an.

  3. Wählen Sie auf der Seite Image die Resources (nur die für die festgelegte Verbindung anwendbaren Ressourcen werden aufgelistet), ein Masterimage, das als Vorlage zum Erstellen der Imageversion 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 Masterimage VDA 2311 oder höher installiert ist und der MCSIO-Treiber auf dem VDA installiert ist.
    • Der Instance Metadata Service (IMDS) V2 wird nur unterstützt, nicht IMDS V1. Weitere Informationen finden Sie unter So funktioniert Instance Metadata Service Version 2.
  4. Wählen Sie auf der Seite Maschinenspezifikation eine Maschinengröße aus. Die Maschinengröße des Maschinenprofils (ausgewählt auf der Seite Image) ist standardmäßig ausgewählt.
  5. Wählen oder fügen Sie auf der Seite NICs NICs für das Vorbereitungsimage hinzu. Wählen Sie für jede NIC ein zugehöriges VPC-Subnetz aus.
  6. Geben Sie auf der Seite Versionsbeschreibung eine Beschreibung für die erstellte anfängliche Imageversion ein.
  7. Überprüfen Sie auf der Seite Zusammenfassung die Details der Imagestruktur und der erstellten anfänglichen Imageversion. Geben Sie einen Namen und eine Beschreibung für die Imagestruktur ein. Klicken Sie auf Fertig stellen.

Imageversionen erstellen

Imageversionen 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 Imageversionen aus der anfänglichen Imageversion zu erstellen:

Hinweis:

Die Hosting-Einheit aller Imageversionen muss identisch sein.

  1. Gehen Sie zum Knoten Images, wählen Sie eine Imageversion oder eine Imagestruktur aus und klicken Sie auf Imageversion erstellen.
  2. Auf der Seite Imagestruktur können Sie die Hosting-Einheit ändern und das Masterimage sowie das Maschinenprofil für diese Imageversion neu auswählen.
  3. Wenn die Konfiguration der Imageversion von der anfänglich konfigurierten Imageversion abweichen soll, konfigurieren Sie die Einstellungen auf den Seiten Maschinenspezifikation und NICs des Dialogfelds Imageversion erstellen.
  4. Fügen Sie eine Beschreibung für die Imageversion hinzu. Klicken Sie auf Fertig stellen.

Hinweis:

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

PowerShell verwenden

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 Test-ProvImageDefinitionNameAvailable command. Zum Beispiel:

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

  2. Erstellen Sie eine Image-Definition mit dem Befehl New-ProvImageDefinition. Zum 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. Zum 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. Zum 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. Zum 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 Spezifikation für eine vorbereitete Image-Version haben.
  • Alle Spezifikationen der Image-Version müssen ein Maschinenprofil aufweisen.

Freigeben vorbereiteter Images über Verfügbarkeitszonen und Regionen hinweg

Sie können jetzt ein einziges 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 freigeben. Dies ermöglicht es Ihnen, ein vorbereitetes Image zu verwenden, um MCS-Maschinenkataloge in verschiedenen Verfügbarkeitszonen und Regionen zu erstellen und zu aktualisieren. Bei der Freigabe über verschiedene AZs in verschiedenen Regionen wird die vorbereitete Image-Version von der ursprünglichen Region in die Zielregionen kopiert.

Sie können ein einziges vorbereitetes Image verwalten und es verwenden, um Maschinenkataloge über mehrere Verfügbarkeitszonen und Regionen hinweg, die an verschiedene Hosting-Einheiten gebunden sind, zu erstellen und zu aktualisieren. Dies reduziert Ihren Verwaltungsaufwand für Images erheblich, gewährleistet die Konsistenz über Bereitstellungen hinweg und optimiert den Bereitstellungsprozess. Sie können auch vorhandene 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 (z. B. us-east-1a). Sie können dieses Image dann für andere Verfügbarkeitszonen wie us-east-1b innerhalb derselben us-east-1 AWS-Region oder us-west-1a in einer anderen us-west-1 Region freigeben. Dies ermöglicht es, dass ein einziges Image mehrere Hosting-Einheiten bedient und vereinfacht die Wartung für Sie.
  • Effiziente Katalogerstellung und -aktualisierung: Sie können ein in AZ 1 (z. B. us-east-1a) erstelltes vorbereitetes Image verwenden, um neue Kataloge in AZ 1 zu erstellen. Nachdem Sie dieses Image für AZ 2 (z. B. 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 einer anderen AWS-Region und einem anderen AWS-Konto aufweist, können Sie vorbereitete Images effizient zwischen diesen Hosting-Einheiten freigeben.

Einschränkungen

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

Wichtige Überlegungen

  • Löschreihenfolge: Um eine ursprüngliche Spezifikation einer vorbereiteten Image-Version zu löschen, müssen Sie zuerst alle ihre freigegebenen Spezifikationen der Image-Version löschen. Alternativ müssen Sie die ursprünglichen und freigegebenen Spezifikationen gleichzeitig löschen.
  • Abhängigkeit der Image-Version: 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-Rückwärtskompatibilität: Sie können vorhandene 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, kann es in keiner Verfügbarkeitszone mehr verwendet werden, 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 Hostverbindungen (jede kann an eine andere Region gebunden sein) unter demselben AWS-Konto konfigurieren.

Konfigurieren über die Web Studio-Benutzeroberfläche

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

So geben Sie ein vorbereitetes Image frei

  1. Navigieren Sie zum Knoten Images des Web Studios und wählen Sie die vorbereitete Image-Version aus, die Sie für andere Verfügbarkeitszonen freigeben möchten.
  2. Wählen Sie in der oberen Navigationsleiste Image-Freigabe verwalten aus, um die Image-Freigabe für die ausgewählte Image-Version zu verwalten.
  3. Wählen Sie auf der Seite Image-Freigabe verwalten eine oder mehrere Ressourcen aus, für die Sie die Image-Version freigeben möchten. Die Ressourcen können sich in anderen Verfügbarkeitszonen befinden als die ursprüngliche Image-Version.
  4. Klicken Sie auf Speichern, um die Image-Version in den Ressourcen über andere Verfügbarkeitszonen hinweg freizugeben. Die Image-Version wird so aktualisiert, dass sie für die verschiedenen von Ihnen ausgewählten Ressourcen freigegeben wird. Sobald dies abgeschlossen ist, verwenden Sie die Image-Version, um Kataloge in den Verfügbarkeitszonen zu erstellen, für die die Image-Version freigegeben ist.

So entfernen Sie die Freigabe eines vorbereiteten Images

  1. Wählen Sie auf dem Knoten Images des Web Studios die vorbereitete Image-Version aus, deren Freigabe Sie aufheben möchten.
  2. Wählen Sie in der oberen Navigationsleiste 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), für die Sie die Freigabe der Image-Version beenden möchten.

    Hinweis:

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

  4. Klicken Sie auf Speichern, um die Freigabe der Ressourcen über die gelöschten Verfügbarkeitszonen hinweg aufzuheben. Die Image-Version wird aktualisiert, sodass sie in diesen Verfügbarkeitszonen nicht mehr freigegeben ist.

Konfigurieren mit PowerShell

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

So geben Sie ein vorbereitetes Image frei

  1. Stellen Sie sicher, dass Sie die ImageVersionSpecUid des vorbereiteten Images haben, das Sie freigeben möchten. Sie können dies mit Get-ProvImageVersionSpec oder ähnlichen Get- Befehlen in PowerShell abrufen.
  2. Bestimmen Sie die 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 Ziel-Verfü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 Web Studio-Benutzeroberfläche sehen, der anzeigt, dass Sie es mit der angegebenen Hosting-Einheit geteilt haben.

So heben Sie die Freigabe eines vorbereiteten Images auf

  1. Stellen Sie sicher, dass Sie die ImageVersionSpecUid des vorbereiteten Images haben, dessen Freigabe Sie aufheben möchten.
  2. Bestimmen Sie die 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 Ziel-Verfü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
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.