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à.
Creazione dell'immagine AppStream 2.0 in modo programmatico utilizzando le operazioni di interfaccia della linea di comando (CLI) di Image Assistant
Puoi creare immagini Amazon AppStream 2.0 collegandoti a un Image Builder e utilizzando l'interfaccia utente (GUI) o l'interfaccia della linea di comando (CLI) di Image Assistant. Le operazioni dell'interfaccia a riga di comando di Image Assistant offrono funzionalità simili all’l'interfaccia grafica utente di Image Assistant. Con queste operazioni, è possibile eseguire le operazioni seguenti in modo programmatico:
Gestire le applicazioni che sono inclusi in un'immagine.
Salvare, aggiornare e ripristinare le impostazioni dell'applicazione di default.
Abilitazione o disabilitazione del framework di applicazioni dinamiche AppStream 2.0.
Specificare i tag.
Creare un'immagine.
Puoi utilizzare queste operazioni per integrare la creazione di immagini AppStream 2.0 con il processo continuo di sviluppo software di integrazione o implementazione.
Per lavorare con le operazioni dell'interfaccia a riga di comando di Image Assistant, utilizzare lo shell della riga di comando a scelta su un image builder. Ad esempio, è possibile usare il prompt dei comandi di Windows o PowerShell.
Nota
L'Image Builder deve utilizzare una versione dell'agente AppStream 2.0 rilasciata a partire dal 26 luglio 2019. Se non si dispone di un image builder, è necessario crearne uno. Per ulteriori informazioni, consulta Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming.
Indice
- Creazione di applicazioni di default e impostazioni di Windows con le operazioni dell'interfaccia a riga di comando di Image Assistant
- Ottimizzazione delle performance di avvio delle applicazioni con le operazioni dell'interfaccia a riga di comando di Image Assistant
- Panoramica del processo per la creazione programmatica di un'immagine AppStream 2.0
- Operazioni di interfaccia della linea di comando (CLI) di Image Assistant per la creazione e la gestione dell'immagine AppStream 2.0
Creazione di applicazioni di default e impostazioni di Windows con le operazioni dell'interfaccia a riga di comando di Image Assistant
È possibile creare applicazioni di default e le impostazioni di Windows in modo che gli utenti possono iniziare a utilizzare le proprie applicazioni in modo rapido. Quando crei queste impostazioni, AppStream 2.0 sostituisce il profilo utente predefinito di Windows con il profilo configurato. Il profilo utente Windows predefinito viene quindi utilizzato per creare le impostazioni iniziali per gli utenti nel parco istanze. Se si creano queste impostazioni utilizzando l'interfaccia a riga di comando di Image Assistant, le operazioni di installazione, o l'automazione, devono modificare il profilo utente predefinito direttamente.
Per sovrascrivere il profilo utente predefinito di Windows con quello di un altro utente Windows, puoi utilizzare anche l'operazione update-default-profile della CLI di Image Assistant.
Per ulteriori informazioni sulla configurazione dell’applicazione predefinita e sulle impostazioni di Windows, consulta Creazione di impostazioni predefinite di applicazioni e Windows per gli utenti AppStream 2.0 in Impostazioni di applicazioni e Windows predefinite e prestazioni di avvio delle applicazioni.
Ottimizzazione delle performance di avvio delle applicazioni con le operazioni dell'interfaccia a riga di comando di Image Assistant
AppStream 2.0 ottimizza le prestazioni di avvio delle applicazioni per le sessioni di streaming degli utenti. Quando si effettua questa operazione utilizzando l'interfaccia a riga di comando di Image Assistant, è possibile specificare i file per ottimizzare l'avvio dell’applicazione. Aggiungere i file al manifest di ottimizzazione dell'applicazione riduce il tempo necessario per l'avvio dell’applicazione per la prima volta su un nuovo parco istanze. Tuttavia, ciò aumenta anche il tempo necessario per consentire al parco istanze di essere disponibile agli utenti. Il manifest di ottimizzazione è un file di testo delimitato da tabulazioni per applicazione.
Nota
Se si esegue l’onboarding dei manifest di ottimizzazione dell'applicazione utilizzando sia le operazioni dell'interfaccia a riga di comando (CLI) sia la GUI di Image Assistant, allora i manifest si uniscono.
Di seguito è riportato un esempio di file manifesto di ottimizzazione dell'applicazione:
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
Per ulteriori informazioni su come ottimizzare le prestazioni di avvio delle applicazioni, vedere Ottimizzare le prestazioni di avvio delle applicazioni in Impostazioni di applicazioni e Windows predefinite e prestazioni di avvio delle applicazioni.
Panoramica del processo per la creazione programmatica di un'immagine AppStream 2.0
Puoi utilizzare le utilizzando le operazioni di interfaccia della linea di comando (CLI) di Image Assistant con l’automazione dell’installazione dell'applicazione per creare un flusso di lavoro di creazione delle immagini AppStream 2.0 completamente programmatico. Quando l’automazione dell’installazione dell’applicazione è completa, ma prima che l'immagine venga creata, utilizzare le operazioni dell'interfaccia a riga di comando (CLI) di Image Assistant per specificare le operazioni seguenti:
Il file eseguibili che gli utenti possono avviare
I manifest di ottimizzazione per le applicazioni
Altri metadati delle immagini di AppStream 2.0
La seguente panoramica di alto livello descrive il processo per la creazione di un'immagine AppStream 2.0 in modo programmatico.
Usa l’automazione di installazione dell’applicazione per installare le applicazioni necessarie per l’image builder. Questa installazione può includere le applicazioni che gli utenti lanceranno, eventuali dipendenze e le applicazioni in background.
Determinare i file e le cartelle da ottimizzare.
Se applicabile, utilizza l’operazione
add-applicationdell'interfaccia della linea di comando (CLI) di Image Assistant per specificare i metadati dell'applicazione e il manifesto di ottimizzazione dell’immagine di AppStream 2.0.Per specificare ulteriori applicazioni per l'immagine AppStream 2.0, ripeti le fasi da 1 a 3 per ogni applicazione in base alle esigenze.
-
Se applicabile, utilizzare l'operazione dell’interfaccia a riga di comando
update-default-profiledi Image Assistant per sovrascrivere il profilo Windows predefinito e creare applicazioni e impostazioni Windows predefinite per gli utenti. Utilizzare l’operazione
create-imagedell’interfaccia a riga di comando di Image Assistant per creare l'immagine.
Operazioni di interfaccia della linea di comando (CLI) di Image Assistant per la creazione e la gestione dell'immagine AppStream 2.0
Questa sezione descrive le operazioni di interfaccia della linea di comando (CLI) di Image Assistant che puoi utilizzare per creare e gestire l’immagine AppStream 2.0.
Negli Image Builder di Windows, il file eseguibile che include l'interfaccia della linea di comando è disponibile in: C:\Program Files\Amazon\Photon\ConsoleImageBuilder\Image-Assistant.exe. Per praticità, questo file eseguibile è incluso nella variabile PATH di Windows. Questo servizio consente di chiamare le operazioni dell'interfaccia a riga di comando di Image Assistant senza specificare il percorso assoluto al file eseguibile. Per chiamare queste operazioni, digitare il comando image-assistant.exe.
Negli Image Builder di Linux, lo strumento Image Assistant si trova in /usr/local/appstream/image-assistant/AppStreamImageAssistant, con un collegamento simbolico a /bin/AppStreamImageAssistant.
Operazione help
Consente di recuperare un elenco di tutte le operazioni dell'interfaccia a riga di comando di Image Assistant. 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. Ad 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 di AppStream 2.0. Le applicazioni in questo elenco sono incluse nel catalogo delle applicazioni. Gli utenti visualizzano il catalogo quando accedono a una sessione di streaming di 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 specifichi 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 per il file eseguibile non è disponibile un’icona predefinita, viene utilizzata un'icona predefinita delle applicazioni 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."} | L'applicazione non è stata aggiunta perché il numero massimo di applicazioni che possono essere aggiunte al catalogo delle applicazioni AppStream 2.0 è 50. |
| 1 | {"status": 1, "messaggio": "Nome non è univoco"} | Un'applicazione con questo nome esiste già nel catalogo delle applicazioni AppStream 2.0. |
| 1 | {"status": 1, "message": "File not found (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 è disinstallata o modificata, ma gli utenti non saranno in grado di lanciarla dal catalogo delle applicazioni di 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 strumento CLI di Image Assistant di Linux.
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 specifichi un utente, viene utilizzato l’account Template User di 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 strumento CLI di Image Assistant di Linux.
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 delle immagini, generando un'immagine AppStream 2.0 che può essere usata per i parchi istanze 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 la regione AWS di 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 di applicazioni dinamiche AppStream 2.0. Se non si specifica un parametro, il supporto per il framework di applicazioni dinamiche non è abilitato.
Il framework di applicazioni dinamiche fornisce operazioni all'interno di un'istanza di streaming AppStream 2.0 che puoi utilizzare per creare un provider di app dinamiche. 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 Utilizza il framework di applicazioni dinamiche di AppStream 2.0 per compilare un provider di app dinamiche.
--use-latest-agent-version|--no-use-latest-agent-version-
Specifica se aggiungere l'immagine alla versione dell'agente AppStream 2.0 attualmente installato o se utilizzare sempre la versione più recente dell'agente. Se non specifichi un parametro, l'immagine viene aggiunta alla versione dell'agente AppStream 2.0 attualmente installato. Per ulteriori informazioni, consulta Gestione delle 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 Assegnazione di tag alle risorse di 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 |
