Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant
<a name="programmatically-create-image"></a>

Sie können Amazon WorkSpaces Applications-Images erstellen, indem Sie eine Verbindung zu einem Image Builder herstellen und die grafische Benutzeroberfläche (GUI) oder die Befehlszeilenschnittstelle (CLI) von Image Assistant verwenden. Die Image Assistant-CLI-Operationen bieten Funktionen ähnlich wie die Image Assistant-GUI. Mit diesen Operationen können Sie programmgesteuert Folgendes tun:
+ Verwalten der Anwendungen, die in einem Abbild enthalten sind
+ Speichern, Aktualisieren und Zurücksetzen der Standardanwendungseinstellungen
+ Aktivieren oder deaktivieren Sie das dynamische WorkSpaces Anwendungs-Framework für Anwendungen.
+ Eingeben von Tags
+ Erstellen eines Abbilds

 Sie können diese Operationen verwenden, um die Erstellung von WorkSpaces Anwendungs-Images in Ihren kontinuierlichen Integrations- oder Bereitstellungsprozess für Software zu integrieren.

Um mit den CLI-Operationen des Image Assistant zu arbeiten, verwenden Sie die Befehlszeilen-Shell Ihrer Wahl auf einem Image Builder. Sie können beispielsweise die Windows-Eingabeaufforderung oder verwenden PowerShell.

**Anmerkung**  
Der Image Builder muss eine Version des WorkSpaces Applications Agent verwenden, die am oder nach dem 26. Juli 2019 veröffentlicht wurde. Wenn Sie nicht über einen Image Builder verfügen, müssen Sie einen erstellen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).

**Topics**
+ [Erstellen von Standardanwendungs- und -Windows-Einstellungen mit den CLI-Operationen des Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Optimieren der Startleistung Ihrer Anwendungen mit den CLI-Operationen des Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Prozessübersicht für die programmgesteuerte Erstellung eines Amazon WorkSpaces Applications-Images](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Image Assistant CLI-Operationen zum Erstellen und Verwalten Ihres Amazon WorkSpaces Applications-Images](cli-operations-managing-creating-image-image-assistant.md)

# Erstellen von Standardanwendungs- und -Windows-Einstellungen mit den CLI-Operationen des Image Assistant
<a name="create-default-app-windows-settings-image-assistant"></a>

Sie können Standardanwendungen und Windows-Einstellungen erstellen, damit Ihre Benutzer schnell mit ihren Anwendungen beginnen können. Wenn Sie diese Einstellungen erstellen, ersetzt WorkSpaces Applications das Windows-Standardbenutzerprofil durch das Profil, das Sie konfigurieren. Anhand des Windows-Standard-Benutzerprofils werden dann die anfänglichen Einstellungen für Benutzer in der Flotten-Instance erstellt. Wenn Sie diese Einstellungen mit Hilfe der Image Assistant CLI-Operationen erstellen, sollte Ihr Anwendungsinstallationsprogramm oder die Automatisierung das Windows-Standardbenutzerprofil direkt ändern.

Um das Windows-Standardbenutzerprofil mit dem eines anderen Windows-Benutzers zu überschreiben, können Sie auch die CLI-Operation `update-default-profile` des Image Assistant verwenden.

Weitere Informationen zur Konfiguration der Standardanwendungs- und Windows-Einstellungen finden Sie unter *Erstellen von Standardanwendungs- und Windows-Einstellungen für Ihre WorkSpaces Anwendungsbenutzer* in[Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications](customizing-appstream-images.md).

# Optimieren der Startleistung Ihrer Anwendungen mit den CLI-Operationen des Image Assistant
<a name="optimize-app-launch-performance-image-assistant-cli"></a>

WorkSpaces Mit Anwendungen können Sie die Startleistung Ihrer Anwendungen für die Streaming-Sitzungen Ihrer Benutzer optimieren. Wenn Sie dies tun, indem Sie die Image Assistant-CLI-Operationen verwenden, können Sie die zu optimierenden Dateien für Ihre Anwendung einzlen angeben. Das Hinzufügen von Dateien zum Manifest zur Anwendungsoptimierung verkürzt die Zeit, die die Anwendung benötigt, um zum ersten Mal auf einer neuen Flotten-Instance zu starten. Dadurch dauert es aber auch länger, bis die Flotten-Instances den Nutzern zur Verfügung gestellt werden. Das Optimierungsmanifest ist eine zeilengetrennte Textdatei, die für jede Anwendung erstellt wird. 

**Anmerkung**  
Wenn Sie Anwendungsoptimierungsmanifeste sowohl mit den CLI-Operationen des Image Assistant als auch mit der Image Assistant GUI integrieren, werden die Manifeste zusammengeführt.

Im Folgenden finden Sie ein Beispiel für eine Manifestdatei zur Anwendungsoptimierung:

```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```

Weitere Informationen zum Optimieren der Startleistung Ihrer Anwendungen finden Sie unter *Optimieren der Startleistung Ihrer Anwendungen* in [Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications](customizing-appstream-images.md).

# Prozessübersicht für die programmgesteuerte Erstellung eines Amazon WorkSpaces Applications-Images
<a name="process-overview-creating-image-programmatically-image-assistant-cli"></a>

Sie können die CLI-Operationen von Image Assistant zusammen mit der Automatisierung Ihrer Anwendungsinstallation verwenden, um einen vollständig programmgesteuerten Workflow für die Erstellung von WorkSpaces Anwendungs-Images zu erstellen. Nachdem die Automatisierung der Anwendungsinstallation abgeschlossen ist, aber bevor das Abbild erstellt wird, verwenden Sie die CLI-Operationen des Image Assistant, um Folgendes festzulegen:
+ Die ausführbaren Dateien, die Ihre Benutzer starten können
+ Die Optimierungsmanifeste für Ihre Anwendungen
+  WorkSpaces Bildmetadaten für andere Anwendungen

In der folgenden allgemeinen Übersicht wird der Prozess zum programmgesteuerten Erstellen eines WorkSpaces Anwendungsabbilds beschrieben.

1. Verwenden Sie die Installationsautomatisierung Ihrer Anwendung, um die erforderlichen Anwendungen auf Ihrem Image Builder zu installieren. Diese Installation kann Anwendungen enthalten, die Ihre Benutzer starten werden, sowie mögliche Abhängigkeiten und Hintergrundanwendungen.

1. Bestimmen Sie die zu optimierenden Dateien und Ordner.

1. Verwenden Sie gegebenenfalls den `add-application` CLI-Vorgang Image Assistant, um die Anwendungsmetadaten und das Optimierungsmanifest für das WorkSpaces Anwendungs-Image anzugeben.

1. Um weitere Anwendungen für das WorkSpaces Anwendungs-Image anzugeben, wiederholen Sie die Schritte 1 bis 3 für jede Anwendung nach Bedarf.

1. Falls zutreffend, verwenden Sie die CLI-Operation `update-default-profile` des Image Assistant, um das Standard-Windows-Profil zu überschreiben und Standardanwendungs- und -Windows-Einstellungen für Ihre Benutzer zu erstellen.

1. Verwenden Sie die CLI-Operation `create-image` des Image Assistant, um das Abbild zu erstellen.

# Image Assistant CLI-Operationen zum Erstellen und Verwalten Ihres Amazon WorkSpaces Applications-Images
<a name="cli-operations-managing-creating-image-image-assistant"></a>

In diesem Abschnitt werden die CLI-Operationen von Image Assistant beschrieben, mit denen Sie Ihr WorkSpaces Anwendungs-Image erstellen und verwalten können.

In Windows Image Buildern befindet sich die ausführbare Datei, die die Befehlszeilenschnittstelle enthält, unter: C:\$1Program Files\$1 Amazon\$1 Photon\$1ConsoleImageBuilder\$1 Image-Assistant.exe. Praktischerweise ist diese ausführbare Datei in der Windows PATH-Variablen enthalten. So können Sie die CLI-Operationen des Image Assistant aufrufen, ohne den absoluten Pfad zur ausführbaren Datei anzugeben. Um diese Operationen aufzurufen, geben Sie den **image-assistant.exe**-Befehl ein.

Auf Linux-Image-Buildern befindet sich das Image-Assistant-Tool unter/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.

## `help`-Operation
<a name="help-operation-image-assistant-cli"></a>

Ruft eine Liste aller CLI-Operationen des Image Assistant ab. Für jede Operation in der Liste wird eine Beschreibung und Verwendungssyntax angegeben. Um Hilfe für eine bestimmte Operation anzuzeigen, geben Sie den Namen der Operation und den Parameter **--help** ein. Beispiel:

```
add-application --help
```

**Syntax**

```
help
```

**Ausgabe**

Druckt die Liste der verfügbaren Operationen mit einer Beschreibung der Funktion an die Standardausgabe.

## `add-application`-Operation
<a name="add-application-operation-image-assistant-cli"></a>

Fügt die Anwendung der Anwendungsliste für WorkSpaces Anwendungsbenutzer hinzu. Anwendungen in dieser Liste sind im Anwendungskatalog enthalten. Der Anwendungskatalog wird Benutzern angezeigt, wenn sie sich bei einer WorkSpaces Anwendungs-Streaming-Sitzung anmelden.

**Anmerkung**  
Wenn Sie Änderungen an einer Anwendungskonfiguration vornehmen müssen, entfernen Sie die Anwendung und fügen Sie die Anwendung mit den aktualisierten Einstellungen hinzu.

**Syntax**

```
add-application
--name <value>
--absolute-app-path <value>
[--display-name <value>]
[--absolute-icon-path <value>]
[--working-directory <value>]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path <value>]
```

**Optionen**

**`--name` (string)**  
Ein eindeutiger Name für die Anwendung. Die maximale Länge beträgt 256 Zeichen. Sie können bis zu 50 Anwendungen hinzufügen. Sie können keine Leerzeichen verwenden.

**`--absolute-app-path` (string)**  
Der absolute Pfad zu der ausführbaren Datei, eine Batchdatei oder ein Skript für die Anwendung. Der Pfad muss auf eine gültige Datei verweisen.

**`--display-name` (string)**  
Der Anzeigename für die Anwendung im Anwendungskatalog. Wenn Sie keinen Anzeigenamen angeben, erstellt WorkSpaces Applications einen Namen, der vom Namen der ausführbaren Datei abgeleitet ist. Der Name wird ohne Dateierweiterung und mit Unterstrichen anstelle von Leerzeichen erstellt. Die maximale Länge beträgt 256 Zeichen.

**`--absolute-icon-path` (string)**  
Der absolute Pfad zum Symbol für die Anwendung. Der Pfad muss auf eine gültige Symboldatei eines der folgenden Dateitypen verweisen: .jpg, .png oder .bmp. Die maximalen Abmessungen lauten: 256 px x 256 px. Wenn Sie keinen Pfad angeben, wird das Standardsymbol der ausführbaren Datei verwendet, sofern verfügbar. Wenn für die ausführbare Datei kein Standardsymbol verfügbar ist, wird ein Standardsymbol für WorkSpaces Anwendungen verwendet.

**`--working-directory` (string)**  
Das anfängliche Arbeitsverzeichnis für die Anwendung beim Start der Anwendung.

**`--absolute-manifest-path` (string)**  
Der Pfad zu einer neuen zeilengetrennte Textdatei. Die Datei gibt die absoluten Pfade der zu optimierenden Dateien an, bevor die Flotten-Instance einem Benutzer zum Streaming zur Verfügung gestellt wird. Der Pfad muss auf eine gültige Textdatei verweisen.

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": 0, "Nachricht": "Erfolgreich"\$1  |  Die Anwendung wurde erfolgreich hinzugefügt.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1  |  Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Fehler beim Hinzufügen von mehr als 50 Anwendungen zum Katalog."\$1  |  Die Anwendung konnte nicht hinzugefügt werden, da die maximale Anzahl von Anwendungen, die dem WorkSpaces Anwendungskatalog hinzugefügt werden können, 50 beträgt.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Name ist nicht eindeutig"\$1  |  Eine Anwendung mit diesem Namen ist bereits im WorkSpaces Anwendungskatalog vorhanden.  | 
| 1 |  \$1"status“: 1, „message“: „Datei nicht gefunden (absolute-app-path)"\$1  |  Die für absolute-app-path angegebene Datei konnte nicht gefunden werden.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Nicht unterstützte Dateierweiterung"\$1  |  Der Parameter Absolute-app-path unterstützt nur die folgenden Dateitypen: .exe und.bat  | 
| 1 |  \$1"Status": 1, "Nachricht": "Verzeichnis nicht gefunden (Arbeitsverzeichnis)"  |  Das für working-directory angegebene Verzeichnis konnte nicht gefunden werden.  | 
| 1 |  \$1"status": 1, "message": "Optimization-manifest not found: <filename>"\$1  |  Die für optimization-manifest angegebene Datei konnte nicht gefunden werden.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Datei nicht gefunden: <filename>"\$1  |  Eine Datei, die innerhalb des Optimierungsmanifests angegeben wurde, konnte nicht gefunden werden.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## `remove-application`-Operation
<a name="remove-application-operation-image-assistant-cli"></a>

Entfernt eine Anwendung aus der Anwendungsliste für das WorkSpaces Anwendungs-Image. Die Anwendung wurde nicht deinstalliert oder geändert, aber Benutzer können sie nicht über den Anwendungskatalog der WorkSpaces Anwendungen starten.

**Syntax**

```
remove-application
--name <value>
```

**Optionen**

**`--name` (string)**  
Die eindeutige Kennung der zu entfernenden Anwendung.

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": 0, "Nachricht": "Erfolgreich"\$1  |  Die Anwendung wurde erfolgreich entfernt.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1  |  Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Anwendung nicht gefunden"\$1  |  Die angegebene Anwendung konnte im WorkSpaces Anwendungskatalog nicht gefunden werden.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## `list-applications`-Operation
<a name="list-applications-operation-image-assistant-cli"></a>

Listet alle Anwendungen auf, die im Anwendungskatalog aufgeführt sind.

**Syntax**

```
list-applications
```

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": "0", "Nachricht": "Erfolgreich", "Anwendungen": [\$1"app1"\$1, \$1........ app2"\$1]\$1  |  Liste der Anwendungen im WorkSpaces Anwendungskatalog.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an uns, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## `update-default-profile`-Operation
<a name="update-default-profile-image-assistant-cli"></a>

Kopiert das angegebene Windows-Benutzerprofil in das Windows-Standard-Benutzerprofil. Neue streamende Benutzer erben die im angegebenen Profil gespeicherten Einstellungen.

**Anmerkung**  
Dieser Vorgang wird vom CLI-Tool des Linux Image Assistant nicht unterstützt. 

**Syntax**

```
update-default-profile
[--profile <value>]
```

**Optionen**

**`--profile` (string)**  
Der Name des Benutzers, dessen Windows-Profil in das Windows-Standardbenutzerprofil kopiert wird. Verwenden Sie das folgende Format für den Namen:  
"<domain>\$1<username>"  
Wenn Ihr Image Builder nicht mit einer Microsoft Active Directory-Domäne verknüpft ist, geben Sie einen Punkt "." für die Domäne ein. Wenn Sie keinen Benutzer angeben, wird das WorkSpaces Applications Template-Benutzerkonto verwendet.

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": 0, "Nachricht": "Erfolgreich"\$1  |  Die Benutzereinstellungen wurden erfolgreich in das Standardprofil von Windows kopiert.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1  |  Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: <path>. <reason>"\$1  |  Die Benutzereinstellungen konnten nicht kopiert werden, da eine Datei oder ein Ordner nicht verfügbar war.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""\$1  |  Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## `reset-user-profile`-Operation
<a name="reset-user-profile-image-assistant-cli"></a>

Löscht das Windows-Benutzerprofil für den angegebenen Benutzer.

**Anmerkung**  
Dieser Vorgang wird vom CLI-Tool des Linux Image Assistant nicht unterstützt. 

**Syntax**

```
reset-user-profile
[--profile <value>]
```

**Optionen**

**`--profile` (string)**  
Der Name des Windows-Benutzers, dessen Windows-Profil gelöscht wird. Verwenden Sie das folgende Format für den Namen:  
"<domain>\$1<username>"  
Wenn Ihr Image Builder nicht mit einer Microsoft Active Directory-Domäne verknüpft ist, geben Sie einen Punkt "." für die Domäne ein.

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": 0, "Nachricht": "Erfolgreich"\$1  |  Die angegebenen Benutzereinstellungen wurden erfolgreich gelöscht.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1  |  Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: <path>. <reason>"\$1  |  Die Benutzereinstellungen konnten nicht zurückgesetzt werden, da eine Datei oder ein Ordner nicht verfügbar war.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""\$1  |  Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, um Unterstützung AWS Support zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## `create-image`-Operation
<a name="create-image-operation-image-assistant-cli"></a>

Startet den Workflow zur Image-Erstellung, was zu einem WorkSpaces Anwendungs-Image führt, das für WorkSpaces Anwendungsflotten verwendet werden kann.

**Syntax**

```
create-image
--name <value>
[--description <value>]
[--display-name <value>]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]            
[--tags <value>]
[--dry-run]
```

**Optionen**

**`--name` (string)**  
Der Name für das WorkSpaces Anwendungs-Image. Der Name muss innerhalb des Amazon Web Services Services-Kontos und der AWS Region eindeutig sein. Die maximale Länge beträgt 100 Zeichen. Zulässige Zeichen sind:  
a-z, A-Z, 0-9, Unterstriche (\$1), Bindestriche (-) und Punkte (.)  
Der Abbildname darf nicht mit einem der folgenden Präfixe beginnen: "aws", "appstream" und "amazon". Diese Präfixe sind für die Verwendung in AWS reserviert.

**`--description` (string)**  
Die Beschreibung, die für das Abbild angezeigt werden soll. Die maximale Länge beträgt 256 Zeichen.

**`--display-name` (string)**  
Der Anzeigename für das Abbild. Die maximale Länge beträgt 256 Zeichen.

**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**  
Aktiviert oder deaktiviert die Unterstützung für das WorkSpaces Applications Dynamic Application Framework. Wenn Sie keinen der beiden Parameter angeben, ist die Unterstützung für das dynamische Anwendungs-Framework nicht aktiviert.  
Das dynamische Anwendungsframework bietet Operationen innerhalb einer WorkSpaces Anwendungs-Streaming-Instanz, die Sie verwenden können, um einen dynamischen Anwendungsanbieter zu erstellen. Anbieter dynamischer Apps können diese Operationen zum Ändern des Katalogs der Anwendungen verwenden, auf die Ihre Benutzer in Echtzeit zugreifen können. Weitere Informationen finden Sie unter [Verwenden Sie das WorkSpaces Applications Dynamic Application Framework, um einen dynamischen Anwendungsanbieter zu erstellen](build-dynamic-app-provider.md).

**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**  
Gibt an, ob das Image an die Version des WorkSpaces Applications Agents angehängt werden soll, die aktuell installiert ist, oder ob immer die neueste Agentenversion verwendet werden soll. Wenn Sie keinen der beiden Parameter angeben, wird das Image an die Version des WorkSpaces Applications Agents angeheftet, die derzeit installiert ist. Weitere Informationen finden Sie unter [WorkSpaces Agent-Versionen von Anwendungen verwalten](base-images-agent.md).

**`--tags` (string)**  
Die Tags, die dem Abbild zugeordnet werden sollen. Ein Tag ist ein Schlüsselwertpaar. Verwenden Sie das folgende Format:  
--Tags "mykey" "myval" "mykey2" "myval2"  
Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).

**`--dry-run` (string)**  
Führt die Validierung aus, ohne das Abbild zu erstellen. Verwenden Sie diesen Befehl, um festzustellen, ob es bei Ihrem Abbild Probleme gibt, bevor Sie es erstellen.

**Message Ausgabe**


| Beendigungscode | An Standardausgang gedruckte Nachricht | Description | 
| --- | --- | --- | 
| 0 |  \$1"Status": 0, "Nachricht": "Erfolgreich"\$1  |  Der Workflow zum Erstellen des Abbilds wurde erfolgreich gestartet.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1  |  Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Ein Abbild mit dem angegebenen Namen ist bereits vorhanden"\$1  |  Ein Abbild mit dem angegebenen Namen ist bereits im Amazon-Web-Services-Konto vorhanden.  | 
| 1 |  \$1"Status": 1, "Nachricht": "Ungültiger Wert (Tags)"\$1  |  Die angegebenen Tags sind nicht gültig.  | 
| 255 |  \$1"Status": 255, "Nachricht": <error message>\$1  |  Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, um Unterstützung AWS Support zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/).  |