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.
Image CLI Assistant-Funktionen zum Erstellen und Verwalten Ihres Amazon AppStream 2.0-Images
In diesem Abschnitt werden die Image CLI Assistant-Funktionen beschrieben, mit denen Sie Ihr AppStream 2.0-Image erstellen und verwalten können.
In Windows Image Buildern befindet sich die ausführbare Datei, die die Befehlszeilenschnittstelle enthält, unter: C:\Program Files\ Amazon\ Photon\ConsoleImageBuilder\ Image-Assistant.exe. Der Einfachheit halber ist diese ausführbare Datei in der PATH Windows-Variablen enthalten. Auf diese Weise können Sie die Image CLI Assistant-Operationen aufrufen, ohne den absoluten Pfad zur ausführbaren Datei angeben zu müssen. 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/ mit einem symbolischen Link unter /bin/AppStreamImageAssistant. AppStreamImageAssistant
help-Operation
Ruft eine Liste aller Image CLI Assistant-Operationen 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. Beispielsweise:
add-application --help
Syntax
help
Ausgabe
Druckt die Liste der verfügbaren Operationen mit einer Beschreibung der Funktion an die Standardausgabe.
add-application-Operation
Fügt die Anwendung der Anwendungsliste für AppStream 2.0-Benutzer hinzu. Anwendungen in dieser Liste sind im Anwendungskatalog enthalten. Der Anwendungskatalog wird Benutzern angezeigt, wenn sie sich bei einer AppStream 2.0-Streamingsitzung 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 AppStream 2.0 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 AppStream Standard-2.0-Anwendungssymbol 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 | Beschreibung |
|---|---|---|
| 0 | {"Status": 0, "Nachricht": "Erfolgreich"} | Die Anwendung wurde erfolgreich hinzugefügt. |
| 1 | {"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"} | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | {"Status": 1, "Nachricht": "Fehler beim Hinzufügen von mehr als 50 Anwendungen zum Katalog."} | Die Anwendung konnte nicht hinzugefügt werden, da die maximale Anzahl von Anwendungen, die dem AppStream 2.0-Anwendungskatalog hinzugefügt werden können, 50 beträgt. |
| 1 | {"Status": 1, "Nachricht": "Name ist nicht eindeutig"} | Eine Anwendung mit diesem Namen ist bereits im AppStream 2.0-Anwendungskatalog vorhanden. |
| 1 | {"status“: 1, „message“: „Datei nicht gefunden (absolute-app-path)"} | Die für absolute-app-path angegebene Datei konnte nicht gefunden werden. |
| 1 | {"Status": 1, "Nachricht": "Nicht unterstützte Dateierweiterung"} | Der Parameter Absolute-app-path unterstützt nur die folgenden Dateitypen: .exe und.bat |
| 1 | {"Status": 1, "Nachricht": "Verzeichnis nicht gefunden (Arbeitsverzeichnis)" | Das für working-directory angegebene Verzeichnis konnte nicht gefunden werden. |
| 1 | {"status": 1, "message": "Optimization-manifest not found: <filename>"} | Die für optimization-manifest angegebene Datei konnte nicht gefunden werden. |
| 1 | {"Status": 1, "Nachricht": "Datei nicht gefunden: <filename>"} | Eine Datei, die innerhalb des Optimierungsmanifests angegeben wurde, konnte nicht gefunden werden. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
remove-application-Operation
Entfernt eine Anwendung aus der Anwendungsliste für das AppStream 2.0-Image. Die Anwendung wurde nicht deinstalliert oder geändert, aber Benutzer können sie nicht über den AppStream 2.0-Anwendungskatalog starten.
Syntax
remove-application --name <value>
Optionen
--name(string)-
Die eindeutige Kennung der zu entfernenden Anwendung.
Message Ausgabe
| Beendigungscode | An Standardausgang gedruckte Nachricht | Beschreibung |
|---|---|---|
| 0 | {"Status": 0, "Nachricht": "Erfolgreich"} | Die Anwendung wurde erfolgreich entfernt. |
| 1 | {"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"} | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | {"Status": 1, "Nachricht": "Anwendung nicht gefunden"} | Die angegebene Anwendung konnte im AppStream 2.0-Anwendungskatalog nicht gefunden werden. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
list-applications-Operation
Listet alle Anwendungen auf, die im Anwendungskatalog aufgeführt sind.
Syntax
list-applications
Message Ausgabe
| Beendigungscode | An Standardausgang gedruckte Nachricht | Beschreibung |
|---|---|---|
| 0 | {"Status": "0", "Nachricht": "Erfolgreich", "Anwendungen": [{"app1"}, {........ app2"}]} | Liste der Anwendungen im AppStream 2.0-Anwendungskatalog. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
update-default-profile-Operation
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 Linux-Image-Assistant-Tool 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>\<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 AppStream 2.0-Vorlagenbenutzerkonto verwendet.
Message Ausgabe
| Beendigungscode | An Standardausgang gedruckte Nachricht | Beschreibung |
|---|---|---|
| 0 | {"Status": 0, "Nachricht": "Erfolgreich"} | Die Benutzereinstellungen wurden erfolgreich in das Standardprofil von Windows kopiert. |
| 1 | {"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"} | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | {"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: <path>. <reason>"} | Die Benutzereinstellungen konnten nicht kopiert werden, da eine Datei oder ein Ordner nicht verfügbar war. |
| 1 | {"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""} | Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
reset-user-profile-Operation
Löscht das Windows-Benutzerprofil für den angegebenen Benutzer.
Anmerkung
Dieser Vorgang wird vom CLI Linux-Image-Assistant-Tool 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>\<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 | Beschreibung |
|---|---|---|
| 0 | {"Status": 0, "Nachricht": "Erfolgreich"} | Die angegebenen Benutzereinstellungen wurden erfolgreich gelöscht. |
| 1 | {"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"} | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | {"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: <path>. <reason>"} | Die Benutzereinstellungen konnten nicht zurückgesetzt werden, da eine Datei oder ein Ordner nicht verfügbar war. |
| 1 | {"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""} | Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
create-image-Operation
Startet den Workflow zur Image-Erstellung, was zu einem AppStream 2.0-Image führt, das für AppStream 2.0-Flotten 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 AppStream 2.0-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 (_), 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|--no-enable-dynamic-app-catalog-
Aktiviert oder deaktiviert die Unterstützung für das AppStream 2.0 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 AppStream 2.0-Streaming-Instance, mit der Sie einen dynamischen App-Anbieter erstellen können. 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 AppStream 2.0 Dynamic Application Framework, um einen dynamischen Anwendungsanbieter zu erstellen.
--use-latest-agent-version|--no-use-latest-agent-version-
Gibt an, ob das Image an die aktuell installierte Version des AppStream 2.0-Agenten angeheftet werden soll oder ob immer die neueste Agentenversion verwendet werden soll. Wenn Sie keinen der beiden Parameter angeben, wird das Image an die Version des AppStream 2.0-Agenten angeheftet, die derzeit installiert ist. Weitere Informationen finden Sie unter Agentenversionen AppStream 2.0 verwalten.
--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 Amazon AppStream 2.0-Ressourcen.
--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 | Beschreibung |
|---|---|---|
| 0 | {"Status": 0, "Nachricht": "Erfolgreich"} | Der Workflow zum Erstellen des Abbilds wurde erfolgreich gestartet. |
| 1 | {"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"} | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | {"Status": 1, "Nachricht": "Ein Abbild mit dem angegebenen Namen ist bereits vorhanden"} | Ein Abbild mit dem angegebenen Namen ist bereits im Amazon-Web-Services-Konto vorhanden. |
| 1 | {"Status": 1, "Nachricht": "Ungültiger Wert (Tags)"} | Die angegebenen Tags sind nicht gültig. |
| 255 | {"Status": 255, "Nachricht": <error message>} | 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 |
