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á.
CLIOperações do Image Assistant para criar e gerenciar sua imagem Amazon AppStream 2.0
Esta seção descreve as CLI operações do Assistente de Imagem que você pode usar para criar e gerenciar sua imagem AppStream 2.0.
Nos criadores de imagens do Windows, o arquivo executável que inclui a interface da linha de comando está localizado em: C:\Program Files\ Amazon\ Photon\\ Image-Assistant.exe. ConsoleImageBuilder Para sua conveniência, esse arquivo executável está incluído na PATH variável do Windows. Isso permite que você chame as CLI operações 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 criadores de imagens Linux, a ferramenta de assistente de imagem está localizada em /usr/local/appstream/image-assistant/, com um link simbólico em AppStreamImageAssistant /bin/. AppStreamImageAssistant
Operação do help
Recupera uma lista de todas as CLI operações 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
Adiciona o aplicativo à lista de aplicativos para usuários AppStream 2.0. 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 AppStream 2.0.
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, AppStream 2.0 cria 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 AppStream 2.0 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 | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | O aplicativo foi adicionado com êxito. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | São necessários privilégios de administrador para concluir a operação. |
| 1 | {"status": 1, "message": "Unable to add more than 50 apps to the catalog."} | O aplicativo não pôde ser adicionado porque o número máximo de aplicativos que podem ser adicionados ao catálogo de aplicativos AppStream 2.0 é 50. |
| 1 | {"status": 1, "message": "Name is not unique"} | Já existe um aplicativo com esse nome no catálogo de aplicativos AppStream 2.0. |
| 1 | {"status”: 1, “mensagem”: “Arquivo não encontrado (absolute-app-path)"} | O arquivo que foi especificado para absolute-app-path não foi encontrado. |
| 1 | {"status": 1, "message": "Unsupported file extension"} | O parâmetro Absolute-app-path só é compatível com os seguintes tipos de arquivos: .exe e .bat. |
| 1 | {"status": 1, "message": "Directory not found (working-directory)" | O diretório que foi especificado working-directory não foi encontrado. |
| 1 | {"status": 1, "message": "Optimization-manifest not found: <nome do arquivo>"} | O arquivo que foi especificado para optimization-manifest não foi encontrado. |
| 1 | {"status": 1, "message": "File not found: <nome do arquivo>"} | Um arquivo que foi especificado no manifesto de otimização não foi encontrado. |
| 255 | {"status": 255, "message": <mensagem de erro>} | 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 |
Operação do remove-application
Remove um aplicativo da lista de aplicativos para a imagem AppStream 2.0. O aplicativo não foi desinstalado nem modificado, mas os usuários não poderão iniciá-lo a partir do catálogo de aplicativos AppStream 2.0.
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 | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | O aplicativo foi removido com êxito. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | São necessários privilégios de administrador para concluir a operação. |
| 1 | {"status": 1, "message": "App not found"} | O aplicativo especificado não pôde ser encontrado no catálogo de aplicativos AppStream 2.0. |
| 255 | {"status": 255, "message": <mensagem de erro>} | 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 |
Operação do list-applications
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 | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success", "applications": [ {..app1.. }, { ..app2.. }]} | Lista de aplicativos no catálogo de aplicativos AppStream 2.0. |
| 255 | {"status": 255, "message": <mensagem de erro>} | 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 |
Operação do update-default-profile
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 é suportada pela CLI ferramenta de assistente de imagem 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>\<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 modelo AppStream 2.0 será usada.
Saída de mensagem
| Código de saída | Mensagem impressa na saída padrão | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | As configurações do usuário foram copiados para o perfil padrão do Windows. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | São necessários privilégios de administrador para concluir a operação. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <caminho>. <motivo>"} | As configurações do usuário não foram copiadas porque um arquivo ou uma pasta estava indisponível. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | 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 | {"status": 255, "message": <mensagem de erro>} | 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 |
Operação do reset-user-profile
Exclui o perfil de usuário do Windows para o usuário especificado.
nota
Essa operação não é suportada pela CLI ferramenta de assistente de imagem 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>\<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 | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | As configurações do usuário especificado foram excluídas com êxito. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | São necessários privilégios de administrador para concluir a operação. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <caminho>. <motivo>"} | As configurações do usuário não puderam ser redefinidas porque um arquivo ou uma pasta estava indisponível. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | 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 | {"status": 255, "message": <mensagem de erro>} | 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 |
Operação do create-image
Inicia o fluxo de trabalho de criação de imagens, resultando em uma imagem AppStream 2.0 que pode ser usada para frotas AppStream 2.0.
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 AppStream 2.0. 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 (_), 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|--no-enable-dynamic-app-catalog-
Ativa ou desativa o suporte para a estrutura dinâmica de aplicativos AppStream 2.0. 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 do aplicativo fornece operações em uma instância de streaming AppStream 2.0 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 Dynamic Application Framework AppStream 2.0 para criar um provedor de aplicativos dinâmico.
--use-latest-agent-version|--no-use-latest-agent-version-
Especifica se a imagem deve ser fixada na versão do agente AppStream 2.0 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 AppStream 2.0 atualmente instalada. Para obter mais informações, consulte Gerenciar versões AppStream 2.0 do agente.
--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 da Amazon AppStream 2.0.
--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 | Descrição |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | O fluxo de trabalho para criar a imagem foi iniciado com êxito. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | São necessários privilégios de administrador para concluir a operação. |
| 1 | {"status": 1, "message": "An image with the given name already exists"} | Já existe uma imagem com o nome especificado na conta da Amazon Web Services. |
| 1 | {"status": 1, "message": "Invalid value (tags)"} | As tags especificadas não são válidas. |
| 255 | {"status": 255, "message": <mensagem de erro>} | 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 |
