As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie sua imagem de WorkSpaces aplicativos da Amazon de forma programática usando as operações de CLI do Image Assistant
<a name="programmatically-create-image"></a>

Você pode criar imagens do Amazon WorkSpaces Applications conectando-se a um construtor de imagens e usando as operações da interface gráfica do usuário (GUI) ou da interface de linha de comando (CLI) do Image Assistant. As operações da CLI do Image Assistant oferecem funcionalidade semelhante à GUI do Image Assistant. Com essas operações, você pode fazer o seguinte de forma programática:
+ Gerenciar os aplicativos que estão incluídos em uma imagem.
+ Salvar, atualizar e redefinir as configurações do aplicativo padrão.
+ Ative ou desative a estrutura dinâmica de WorkSpaces aplicativos.
+ Especificar tags.
+ Criar uma imagem.

 Você pode usar essas operações para integrar a criação de imagens de WorkSpaces aplicativos ao seu processo contínuo de desenvolvimento de software de integração ou implantação.

Para trabalhar com as operações da CLI do Image Assistant, use o shell de linha de comando de sua escolha em um construtor de imagens. Por exemplo, você pode usar o prompt de comando do Windows ou PowerShell.

**nota**  
O criador de imagens deve usar uma versão do agente de WorkSpaces aplicativos lançada em ou após 26 de julho de 2019. Se não tiver um construtor de imagens, você deverá criar um. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).

**Topics**
+ [Criação de configurações padrão de aplicativo e do Windows com as operações da CLI do Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Como otimizar o desempenho de inicialização dos seus aplicativos com as operações da CLI do Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Visão geral do processo para criar programaticamente uma imagem de aplicativos da Amazon WorkSpaces](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operações de CLI do Image Assistant para criar e gerenciar sua imagem de aplicativos Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md)

# Criação de configurações padrão de aplicativo e do Windows com as operações da CLI do Image Assistant
<a name="create-default-app-windows-settings-image-assistant"></a>

Você pode criar configurações padrão de aplicativo e do Windows para que os usuários possam começar a usar seus aplicativos rapidamente. Quando você cria essas configurações, os WorkSpaces Aplicativos substituem o perfil de usuário padrão do Windows pelo perfil que você configura. O perfil de usuário padrão do Windows é, então, usado para criar as configurações iniciais para os usuários na instância de frota. Se você criar essas configurações usando as operações da CLI do Image Assistant, seu instalador de aplicativos, ou a automação, deverá modificar o perfil de usuário padrão do Windows diretamente.

Para substituir o perfil de usuário padrão do Windows pelo de outro usuário do Windows, você também pode usar a operação `update-default-profile` da CLI do Image Assistant.

Para obter mais informações sobre como definir o aplicativo padrão e as configurações do Windows, consulte *Criando configurações padrão do aplicativo e do Windows para os usuários de seus WorkSpaces aplicativos* em[Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon](customizing-appstream-images.md).

# Como otimizar o desempenho de inicialização dos seus aplicativos com as operações da CLI do Image Assistant
<a name="optimize-app-launch-performance-image-assistant-cli"></a>

WorkSpaces Os aplicativos permitem que você otimize o desempenho de lançamento de seus aplicativos para as sessões de streaming de seus usuários. Ao fazer isso usando as operações da CLI do Image Assistant, você pode especificar os arquivos a serem otimizados para a inicialização do aplicativo. A adição de arquivos ao manifesto de otimização do aplicativo reduz o tempo necessário para o aplicativo iniciar pela primeira vez em uma nova instância de frota. No entanto, isso também aumenta o tempo necessário para as instâncias de frota serem disponibilizadas aos usuários. O manifesto de otimização é um arquivo de texto delimitado por linha que é exclusivo de cada aplicativo. 

**nota**  
Se você integrar os manifestos de otimização de aplicativos usando as operações da CLI do Image Assistant e a GUI do Image Assistant, os manifestos serão mesclados.

Veja a seguir um exemplo de um arquivo de manifesto de otimização de aplicações:

```
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
```

Para obter mais informações sobre como otimizar o desempenho de inicialização dos seus aplicativos, consulte *Otimização do desempenho de inicialização dos seus aplicativos* em [Configurações padrão do aplicativo e do Windows e desempenho de lançamento de aplicativos nos WorkSpaces aplicativos da Amazon](customizing-appstream-images.md).

# Visão geral do processo para criar programaticamente uma imagem de aplicativos da Amazon WorkSpaces
<a name="process-overview-creating-image-programmatically-image-assistant-cli"></a>

Você pode usar as operações da CLI do Image Assistant com a automação de instalação do aplicativo para criar um fluxo de trabalho de criação de imagens de WorkSpaces aplicativos totalmente programático. Depois que a sua automação de instalação de aplicativos for concluída, mas antes que a imagem seja criada, use as operações da CLI do Image Assistant para especificar o seguinte:
+ Os arquivos executáveis que os usuários podem iniciar
+ Os manifestos de otimização para seus aplicativos
+ Metadados WorkSpaces de imagem de outros aplicativos

A visão geral de alto nível a seguir descreve o processo de criação programática de uma WorkSpaces imagem de aplicativos.

1. Use sua automação de instalação de aplicativos para instalar os aplicativos necessários em seu construtor de imagens. Essa instalação pode incluir os aplicativos que seus usuários iniciarão, quaisquer dependências e aplicativos em segundo plano.

1. Determine os arquivos e as pastas a serem otimizados.

1. Se aplicável, use a operação `add-application` CLI do Image Assistant para especificar os metadados do aplicativo e o manifesto de otimização para a imagem do WorkSpaces Applications.

1. Para especificar aplicativos adicionais para a imagem de WorkSpaces Aplicativos, repita as etapas de 1 a 3 para cada aplicativo, conforme necessário.

1. Se aplicável, use a operação `update-default-profile` da CLI do Image Assistant para substituir o perfil padrão do Windows e criar configurações padrão de aplicativo e do Windows para seus usuários.

1. Use a operação `create-image` da CLI do Image Assistant para criar a imagem.

# Operações de CLI do Image Assistant para criar e gerenciar sua imagem de aplicativos Amazon WorkSpaces
<a name="cli-operations-managing-creating-image-image-assistant"></a>

Esta seção descreve as operações da CLI do Image Assistant que você pode usar para criar e gerenciar a imagem do WorkSpaces Applications.

Nos criadores de imagens do Windows, o arquivo executável que inclui a interface da linha de comando está localizado em: C:\$1Program Files\$1 Amazon\$1 Photon\$1\$1 Image-Assistant.exe. ConsoleImageBuilder Para sua conveniência, esse arquivo executável está incluído na variável PATH do Windows. Isso permite que você chame as operações da CLI do Image Assistant sem especificar o caminho absoluto para o arquivo executável. Para chamar essas operações, digite o comando **image-assistant.exe**.

Nos construtores de imagens Linux, a ferramenta assistente de imagem está localizada em/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.

## Operação do `help`
<a name="help-operation-image-assistant-cli"></a>

Recupera uma lista de todas as operações da CLI do Image Assistant. Para cada operação na lista, é fornecida uma descrição e uma sintaxe de uso. Para exibir a ajuda para uma operação específica, digite o nome da operação e especifique o parâmetro **--help**. Por exemplo:

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

**Resumo**

```
help
```

**Saída**

Imprime na saída padrão a lista de operações disponíveis com uma descrição de suas funções.

## Operação do `add-application`
<a name="add-application-operation-image-assistant-cli"></a>

Adiciona o aplicativo à lista de WorkSpaces aplicativos para usuários de aplicativos. Os aplicativos nessa lista são incluídos no catálogo de aplicativos. O catálogo de aplicativos é exibido para os usuários quando eles entram em uma sessão de streaming de WorkSpaces aplicativos.

**nota**  
Se você precisar fazer alterações na configuração de uma aplicação, remova a aplicação e adicione-a com as configurações atualizadas.

**Resumo**

```
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>]
```

**Opções**

**`--name` (string)**  
Um nome exclusivo para o aplicativo. O tamanho máximo é de 256 caracteres. Você pode adicionar até 50 aplicativos. Você não pode usar caracteres de espaço em branco.

**`--absolute-app-path` (string)**  
O caminho absoluto para o arquivo executável, o arquivo de lote ou script do aplicativo. O caminho deve apontar para um arquivo válido.

**`--display-name` (string)**  
O nome para exibição do aplicativo no catálogo de aplicativos. Se você não especificar um nome de exibição, os WorkSpaces Aplicativos criarão um nome derivado do nome do arquivo executável. O nome é criado sem a extensão de arquivo e com sublinhados no lugar de espaços. O tamanho máximo é de 256 caracteres.

**`--absolute-icon-path` (string)**  
O caminho absoluto para o ícone do aplicativo. O caminho deve apontar para um arquivo de ícone válido que é um dos seguintes tipos: .jpg, .png ou .bmp. As dimensões máximas são: 256 px x 256 px. Se você não especificar um caminho, o ícone padrão do arquivo executável será usado, se disponível. Se um ícone padrão não estiver disponível para o arquivo executável, um ícone padrão do aplicativo WorkSpaces Aplicativos será usado.

**`--working-directory` (string)**  
O diretório de trabalho inicial do aplicativo quando o aplicativo é iniciado.

**`--absolute-manifest-path` (string)**  
O caminho para um novo arquivo de texto delimitado por linha. O arquivo especifica os caminhos absolutos dos arquivos a serem otimizados antes de a instância de frota ser disponibilizada para streaming. O caminho deve apontar para um arquivo de texto válido.

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  O aplicativo foi adicionado com êxito.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  São necessários privilégios de administrador para concluir a operação.  | 
| 1 |  \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1  |  O aplicativo não pôde ser adicionado porque o número máximo de aplicativos que podem ser adicionados ao catálogo de WorkSpaces aplicativos de aplicativos é 50.  | 
| 1 |  \$1"status": 1, "message": "Name is not unique"\$1  |  Já existe um aplicativo com esse nome no catálogo de WorkSpaces aplicativos de aplicativos.  | 
| 1 |  \$1"status”: 1, “mensagem”: “Arquivo não encontrado (absolute-app-path)"\$1  |  O arquivo que foi especificado para absolute-app-path não foi encontrado.  | 
| 1 |  \$1"status": 1, "message": "Unsupported file extension"\$1  |  O parâmetro Absolute-app-path só é compatível com os seguintes tipos de arquivos: .exe e .bat.  | 
| 1 |  \$1"status": 1, "message": "Directory not found (working-directory)"  |  O diretório que foi especificado working-directory não foi encontrado.  | 
| 1 |  \$1"status": 1, "message": "Optimization-manifest not found: <nome do arquivo>"\$1  |  O arquivo que foi especificado para optimization-manifest não foi encontrado.  | 
| 1 |  \$1"status": 1, "message": "File not found: <nome do arquivo>"\$1  |  Um arquivo que foi especificado no manifesto de otimização não foi encontrado.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## Operação do `remove-application`
<a name="remove-application-operation-image-assistant-cli"></a>

Remove um aplicativo da lista de WorkSpaces aplicativos da imagem Aplicativos. O aplicativo não é desinstalado nem modificado, mas os usuários não poderão iniciá-lo a partir do catálogo de WorkSpaces aplicativos de aplicativos.

**Resumo**

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

**Opções**

**`--name` (string)**  
O identificador exclusivo do aplicativo a ser removido.

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  O aplicativo foi removido com êxito.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  São necessários privilégios de administrador para concluir a operação.  | 
| 1 |  \$1"status": 1, "message": "App not found"\$1  |  O aplicativo especificado não pôde ser encontrado no catálogo de WorkSpaces aplicativos de aplicativos.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## Operação do `list-applications`
<a name="list-applications-operation-image-assistant-cli"></a>

Lista todos os aplicativos que são especificados no catálogo de aplicativos.

**Resumo**

```
list-applications
```

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1  |  Lista de aplicativos no catálogo de WorkSpaces aplicativos de aplicativos.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## Operação do `update-default-profile`
<a name="update-default-profile-image-assistant-cli"></a>

Copia o perfil do usuário do Windows especificado para o perfil de usuário padrão do Windows. Os novos usuários que fizerem streaming herdarão as configurações armazenadas no perfil especificado.

**nota**  
Essa operação não é compatível com a ferramenta de CLI do assistente de imagens do Linux. 

**Resumo**

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

**Opções**

**`--profile` (string)**  
O nome do usuário cujo perfil do Windows será copiado para o perfil de usuário padrão do Windows. Use o seguinte formato para o nome:  
"<domínio>\$1<nome de usuário>"  
Se o seu construtor de imagens não estiver integrado a um domínio do Microsoft Active Directory, insira um ponto "." para o domínio. Se você não especificar um usuário, a conta de usuário do modelo de WorkSpaces aplicativos será usada.

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  As configurações do usuário foram copiados para o perfil padrão do Windows.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  São necessários privilégios de administrador para concluir a operação.  | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <caminho>. <motivo>"\$1  |  As configurações do usuário não foram copiadas porque um arquivo ou uma pasta estava indisponível.  | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Um usuário do domínio do Microsoft Active Directory foi especificado, mas o construtor de imagens não está associado a um domínio do Active Directory.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## Operação do `reset-user-profile`
<a name="reset-user-profile-image-assistant-cli"></a>

Exclui o perfil de usuário do Windows para o usuário especificado.

**nota**  
Essa operação não é compatível com a ferramenta de CLI do assistente de imagens do Linux. 

**Resumo**

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

**Opções**

**`--profile` (string)**  
O nome do usuário do Windows cujo perfil do Windows será excluído. Use o seguinte formato para o nome:  
"<domínio>\$1<nome de usuário>"  
Se o seu construtor de imagens não estiver integrado a um domínio do Microsoft Active Directory, insira um ponto "." para o domínio.

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  As configurações do usuário especificado foram excluídas com êxito.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  São necessários privilégios de administrador para concluir a operação.  | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <caminho>. <motivo>"\$1  |  As configurações do usuário não puderam ser redefinidas porque um arquivo ou uma pasta estava indisponível.  | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Um usuário do domínio do Microsoft Active Directory foi especificado, mas o construtor de imagens não está associado a um domínio do Active Directory.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 

## Operação do `create-image`
<a name="create-image-operation-image-assistant-cli"></a>

Inicia o fluxo de trabalho de criação de imagens, resultando em uma imagem de WorkSpaces aplicativos que pode ser usada para frotas de WorkSpaces aplicativos.

**Resumo**

```
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]
```

**Opções**

**`--name` (string)**  
O nome da imagem dos WorkSpaces aplicativos. O nome deve ser exclusivo na conta e na AWS região da Amazon Web Services. O tamanho máximo é 100 caracteres. Os caracteres permitidos são:  
a–z, A–Z, 0–9, sublinhados (\$1), hifens (-) e pontos (.)  
O nome da imagem não pode começar com nenhum um dos seguintes prefixos: “aws” “appstream” e “amazon”. Esses prefixos são reservados para uso da AWS .

**`--description` (string)**  
A descrição a ser exibida para a imagem. O tamanho máximo é de 256 caracteres.

**`--display-name` (string)**  
O nome a ser exibido para a imagem. O tamanho máximo é de 256 caracteres.

**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**  
Ativa ou desativa o suporte para a estrutura de WorkSpaces aplicativos dinâmicos de aplicativos. Se você não especificar nenhum parâmetro, o suporte para a estrutura de aplicativos dinâmicos não será habilitado.  
A estrutura dinâmica de aplicativos fornece operações em uma instância de streaming de WorkSpaces aplicativos que você pode usar para criar um provedor de aplicativos dinâmico. Os provedores de aplicativos dinâmicos podem usar essas operações para modificar o catálogo de aplicativos que os usuários podem acessar em tempo real. Para obter mais informações, consulte [Use o WorkSpaces Applications Dynamic Application Framework para criar um provedor de aplicativos dinâmico](build-dynamic-app-provider.md).

**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**  
Especifica se a imagem deve ser fixada na versão do agente de WorkSpaces aplicativos atualmente instalada ou se deve sempre usar a versão mais recente do agente. Se você não especificar nenhum dos parâmetros, a imagem será fixada na versão do agente de WorkSpaces aplicativos que está atualmente instalada. Para obter mais informações, consulte [Gerenciar versões do WorkSpaces Applications Agent](base-images-agent.md).

**`--tags` (string)**  
As tags a serem associadas à imagem. Uma tag é um par de chave-valor. Use o formato a seguir:  
--tags "mykey" "myval" "mykey2" "myval2"  
Para obter mais informações sobre tags, consulte [Marcando seus recursos de WorkSpaces aplicativos da Amazon](tagging-basic.md).

**`--dry-run` (string)**  
Executa a validação sem criar a imagem. Use esse comando para identificar se sua imagem tem algum problema antes de criá-la.

**Saída de mensagem**


| Código de saída | Mensagem impressa na saída padrão | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  O fluxo de trabalho para criar a imagem foi iniciado com êxito.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  São necessários privilégios de administrador para concluir a operação.  | 
| 1 |  \$1"status": 1, "message": "An image with the given name already exists"\$1  |  Já existe uma imagem com o nome especificado na conta da Amazon Web Services.  | 
| 1 |  \$1"status": 1, "message": "Invalid value (tags)"\$1  |  As tags especificadas não são válidas.  | 
| 255 |  \$1"status": 255, "message": <mensagem de erro>\$1  |  Ocorreu um erro inesperado. Tente a solicitação novamente. Se o erro persistir, entre em contato AWS Support para obter ajuda. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  |