Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

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

April 6, 2026
Beitrag von: 
C

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

  • Web Studio
  • PowerShell-Befehle

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 Web 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 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 Image-Definition an.

  3. Wählen Sie auf der Seite Image die Resources (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.
    • Der Instance Metadata Service (IMDS) V2 wird nur 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 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 NICs für das Vorbereitungs-Image hinzu. Wählen Sie für jede NIC ein zugehöriges VPC-Subnetz aus.
  6. Geben Sie auf der Seite Version Description eine Beschreibung für die erstellte anfängliche Image-Version ein.
  7. Überprüfen Sie auf der Seite Summary 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.

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.
  2. Auf der Seite 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 und NICs des Dialogfelds Create Image Version.
  4. Fügen Sie eine Beschreibung für die Image-Version hinzu. Klicken Sie auf Finish.

Hinweis:

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

Verwenden von PowerShell

Die detaillierten PowerShell-Befehle zum Erstellen einer vorbereiteten Image-Versionsspezifikation lauten wie folgt:

  1. Überprüfen Sie die verfügbaren Namen der Image-Definitionen mit dem Befehl Test-ProvImageDefinitionNameAvailable. 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 vorbereitete Image-Versionsspezifikation 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

    ```

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

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 freigeben

Sie können jetzt ein einzelnes vorbereitetes Image für Ihre Amazon WorkSpaces Core Managed Instances über verschiedene Verfügbarkeitszonen hinweg, die an unterschiedliche Hosting-Einheiten gebunden sind, innerhalb derselben AWS-Region oder in verschiedenen Regionen freigeben. Dies ermöglicht Ihnen die Verwendung eines vorbereiteten Images, 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 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 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 (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 einer anderen AWS-Region und einem anderen AWS-Konto hat, 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 Image-Versionsspezifikationen 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, 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 diese vorbereitete Image-Version gebunden sind, zuerst gelöscht wurden.

Voraussetzungen

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

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

Konfigurieren über die Web Studio-Benutzeroberfläche

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

So geben Sie ein vorbereitetes Image frei

  1. Navigieren Sie im Web Studio zum Knoten Images 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 der ursprünglichen 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 über die verschiedenen von Ihnen ausgewählten Ressourcen hinweg 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 im 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 deaktivierten Verfügbarkeitszonen hinweg aufzuheben. Die Image-Version wird so aktualisiert, dass sie in diesen Verfügbarkeitszonen nicht mehr freigegeben ist.

Konfigurieren mit PowerShell

Alternativ können Sie vorbereitete Images über Verfügbarkeitszonen hinweg, die an unterschiedliche 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 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 Web Studio-Benutzeroberfläche sehen, der anzeigt, dass Sie es für die angegebene Hosting-Einheit freigegeben 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
April 6, 2026
Beitrag von: 
C
April 6, 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.