Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CLIOperazioni di Image Assistant per la creazione e la gestione di immagini Amazon AppStream 2.0
Questa sezione descrive le CLI operazioni di Image Assistant che è possibile utilizzare per creare e gestire l'immagine AppStream 2.0.
Nei generatori di immagini Windows, il file eseguibile che include l'interfaccia della riga di comando si trova in: C:\Program Files\ Amazon\ Photon\ConsoleImageBuilder\ Image-Assistant.exe. Per comodità, questo file eseguibile è incluso nella variabile WindowsPATH. Ciò consente di richiamare le CLI operazioni di Image Assistant senza specificare il percorso assoluto del file eseguibile. Per chiamare queste operazioni, digitare il comando image-assistant.exe.
Sui generatori di immagini Linux, lo strumento di assistenza alle immagini si trova in /usr/local/appstream/image-assistant/, con un collegamento simbolico in /bin/AppStreamImageAssistant. AppStreamImageAssistant
Operazione help
Recupera un elenco di tutte le operazioni di Image Assistant. CLI Per ogni operazione nell'elenco, vengono fornite una descrizione e una sintassi di utilizzo. Per visualizzare la Guida per un'operazione specifica, digitare il nome dell'operazione e specificare il parametro -help. Per esempio:
add-application --help
Riepilogo
help
Output
Stampa in formato standard l'elenco di operazioni disponibili con una descrizione della loro funzione.
Operazione add-application
Aggiunge l'applicazione all'elenco delle applicazioni per gli utenti AppStream 2.0. Le applicazioni in questo elenco sono incluse nel catalogo delle applicazioni. Il catalogo delle applicazioni viene visualizzato agli utenti quando accedono a una sessione di streaming AppStream 2.0.
Nota
Se devi apportare modifiche alla configurazione di un'applicazione, rimuovi l'applicazione e aggiungi l'applicazione con le impostazioni aggiornate.
Riepilogo
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>]
Opzioni
--name(Stringa)-
Un nome univoco per l'applicazione. La lunghezza massima è 256 caratteri. È possibile aggiungere fino a un massimo di 50 applicazioni. Non è possibile utilizzare caratteri di spazio.
--absolute-app-path(Stringa)-
Il percorso assoluto al file eseguibile, un file batch o uno script per l'applicazione. Il percorso deve puntare a un file valido.
--display-name(Stringa)-
Il nome da visualizzare per l'applicazione nel catalogo dell'applicazione. Se non si specifica un nome visualizzato, AppStream 2.0 crea un nome derivato dal nome del file eseguibile. Il nome viene creato senza l'estensione del file e con il carattere di sottolineatura al posto degli spazi. La lunghezza massima è 256 caratteri.
--absolute-icon-path(Stringa)-
Il percorso assoluto all'icona per l'applicazione. Il percorso deve puntare a un file icona valido con uno dei seguenti formati: .jpg, .png o bmp. Le dimensioni massime sono: 256 px x 256 px. Se non si specifica un percorso, viene utilizzata l'icona predefinita per il file eseguibile, se disponibile. Se non è disponibile un'icona predefinita per il file eseguibile, viene utilizzata un'icona predefinita dell'applicazione AppStream 2.0.
--working-directory(Stringa)-
La directory di lavoro iniziale per l'applicazione quando l'applicazione viene avviata.
--absolute-manifest-path(Stringa)-
Il percorso a un nuovo file di testo delimitato. Il file specifica i percorsi assoluti dei file per l’ottimizzazione prima che il parco istanze sia disponibile a un utente per lo streaming. Il percorso deve puntare a un file di testo valido.
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | L'applicazione è stata aggiunta correttamente. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | {"status": 1, "message": "Unable to add more than 50 apps to the catalog."} | Impossibile aggiungere l'applicazione perché il numero massimo di applicazioni che è possibile aggiungere al catalogo di applicazioni AppStream 2.0 è 50. |
| 1 | {"status": 1, "messaggio": "Nome non è univoco"} | Un'applicazione con quel nome esiste già nel catalogo delle applicazioni AppStream 2.0. |
| 1 | {"status»: 1, «message»: «File non trovato (absolute-app-path)"} | Il file che è stato specificato per absolute-app-path non è disponibile. |
| 1 | {"status": 1, "message": "Unsupported file extension"} | Il parametro Absolute-app-path supporta solo i seguenti tipi di file: .exe e .bat. |
| 1 | {"status": 1, "message": "Directory not found (working-directory)" | La directory specificata per working-directory non è stata trovata. |
| 1 | {"status": 1, "message": "Optimization-manifest not found: <filename>"} | Il file che è stato specificato per optimization-manifest non è disponibile. |
| 1 | {"status": 1, "message": "File not found: <filename>"} | Un file che è stato specificato all'interno del manifest di ottimizzazione non è stato trovato. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
Operazione remove-application
Rimuove un'applicazione dall'elenco delle applicazioni per l'immagine AppStream 2.0. L'applicazione non viene disinstallata o modificata, ma gli utenti non saranno in grado di avviarla dal catalogo delle applicazioni AppStream 2.0.
Riepilogo
remove-application --name <value>
Opzioni
--name(Stringa)-
Identificatore univoco dell'applicazione da rimuovere.
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | L'applicazione è stata rimossa correttamente. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | {"status": 1, "message": "App not found"} | L'applicazione specificata non è stata trovata nel catalogo delle applicazioni AppStream 2.0. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
Operazione list-applications
Elenca tutte le applicazioni che sono specificate nel catalogo delle applicazioni.
Riepilogo
list-applications
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success", "applications": [ {..app1.. }, { ..app2.. }]} | Elenco delle applicazioni nel catalogo delle applicazioni AppStream 2.0. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
Operazione update-default-profile
Copia il profilo utente di Windows specificato sul profilo utente predefinito di Windows. I nuovi utenti che eseguono lo streaming ereditano le impostazioni memorizzate nel profilo specificato.
Nota
Questa operazione non è supportata dallo CLI strumento Linux Image Assistant.
Riepilogo
update-default-profile [--profile <value>]
Opzioni
--profile(Stringa)-
Il nome dell'utente del profilo di Windows sarà copiato nel profilo utente predefinito di Windows. Utilizza il seguente formato per il nome:
"<domain>\<username>"
Se l'Image Builder non è stato aggiunto a un dominio Microsoft Active Directory, immettere un punto "." per il dominio. Se non si specifica un utente, viene utilizzato l'account Template User AppStream 2.0.
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Le impostazioni utente sono state copiate correttamente nel profilo di default di Windows. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"} | Non è stato possibile copiare le impostazioni dell'utente perché un file o una cartella non erano disponibili. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | Un utente di dominio Microsoft Active Directory è stato specificato, ma l'Image Builder non viene aggiunto a un dominio Active Directory. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
Operazione reset-user-profile
Elimina il profilo utente di Windows per l'utente specificato.
Nota
Questa operazione non è supportata dallo CLI strumento Linux Image Assistant.
Riepilogo
reset-user-profile [--profile <value>]
Opzioni
--profile(Stringa)-
Il nome dell'utente Windows il cui profilo di Windows verrà eliminato. Utilizza il seguente formato per il nome:
"<domain>\<username>"
Se l'Image Builder non è stato aggiunto a un dominio Microsoft Active Directory, immettere un punto "." per il dominio.
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Le impostazioni dell'utente specificato sono state eliminate correttamente. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"} | Le impostazioni dell'utente non possono essere reimpostate perché un file o una cartella non era disponibile. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | Un utente di dominio Microsoft Active Directory è stato specificato, ma l'Image Builder non viene aggiunto a un dominio Active Directory. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
Operazione create-image
Avvia il flusso di lavoro di creazione dell'immagine, ottenendo un'immagine AppStream 2.0 che può essere utilizzata per flotte AppStream 2.0.
Riepilogo
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]
Opzioni
--name(Stringa)-
Il nome dell'immagine AppStream 2.0. Il nome deve essere univoco all'interno dell'account e della AWS regione Amazon Web Services. La lunghezza massima è 100 caratteri. I caratteri consentiti sono:
a-z, A-Z, 0-9, caratteri di sottolineatura (_), trattini (-) e punti (.)
Il nome dell'immagine non può iniziare con uno dei seguenti prefissi: “aws”, “appstream” e “amazon”. Questi prefissi sono riservati per l'utilizzo di AWS .
--description(Stringa)-
La descrizione da visualizzare per l'immagine. La lunghezza massima è 256 caratteri.
--display-name(Stringa)-
Il nome da visualizzare per l'immagine. La lunghezza massima è 256 caratteri.
--enable-dynamic-app-catalog|--no-enable-dynamic-app-catalog-
Abilita o disabilita il supporto per il framework applicativo dinamico AppStream 2.0. Se non si specifica un parametro, il supporto per il framework di applicazioni dinamiche non è abilitato.
Il framework applicativo dinamico fornisce operazioni all'interno di un'istanza di streaming AppStream 2.0 che è possibile utilizzare per creare un provider di app dinamico. I provider di app dinamiche possono utilizzare queste operazioni per modificare il catalogo delle applicazioni a cui gli utenti possono accedere in tempo reale. Per ulteriori informazioni, consulta Usa il AppStream 2.0 Dynamic Application Framework per creare un provider di app dinamico.
--use-latest-agent-version|--no-use-latest-agent-version-
Speciifica se aggiungere l'immagine alla versione dell'agente AppStream 2.0 attualmente installata o utilizzare sempre la versione più recente dell'agente. Se non si specifica nessuno dei parametri, l'immagine viene aggiunta alla versione dell'agente AppStream 2.0 attualmente installata. Per ulteriori informazioni, consulta Gestisci le versioni dell'agente AppStream 2.0.
--tags(Stringa)-
I tag da associare all'immagine. Un tag è una coppia chiave-valore. Utilizza il seguente formato:
--tags "mykey" "myval" "mykey2" "myval2"
Per ulteriori informazioni sui tag, consulta Taggare le tue risorse Amazon AppStream 2.0.
--dry-run(Stringa)-
Esegue la convalida senza creare l'immagine. Utilizzare questo comando per identificare se l'immagine dispone di eventuali problemi prima della creazione.
Output messaggio
| Codice di uscita | Messaggio stampato per standard in uscita | Descrizione |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Il flusso di lavoro per creare l'immagine è stato avviato correttamente. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | {"status": 1, "message": "An image with the given name already exists"} | Un’immagine con il nome specificato esiste già nell'account di Amazon Web Services. |
| 1 | {"status": 1, "message": "Invalid value (tags)"} | I tag specificati non sono validi. |
| 255 | {"status": 255, "message": <error message>} | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta AWS Support per ricevere assistenza. Per ulteriori informazioni, consulta Centro di AWS Support |
