Comando list (winget)

O comando list da ferramenta winget exibe uma lista de aplicativos instalados no seu computador no momento. O comando list mostrará aplicativos que foram instalados por meio do Gerenciador de Pacotes do Windows, bem como aplicativos que foram instalados por outros meios.

O comando list também será exibido se uma atualização estiver disponível para um aplicativo, e você poderá usar o comando upgrade para atualizar o aplicativo.

O comando list também dá suporte a filtros que podem ser usados para limitar sua consulta de lista.

Aliases

Os seguintes aliases estão disponíveis para esse comando:

• ls

Uso

winget list [[-q] <query>] [<options>]

Nota

Se você quiser listar todos os aplicativos com atualizações disponíveis, use winget upgrade (sem argumentos).

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-q,--query	A consulta usada para pesquisar um aplicativo.

Nota

O argumento da consulta é posicional. Não há suporte para sintaxe de estilo curinga. Geralmente, essa é a cadeia de caracteres que você espera que ajude a encontrar o pacote instalado que você está procurando.

Opções

As opções permitem que você personalize a experiência de lista para atender às suas necessidades.

Opção	Descrição
--id	Limita a lista à ID do aplicativo.
--name	Limita a lista ao nome do aplicativo.
--moniker	Limita a lista ao moniker listado para o aplicativo.
-s, --source	Restringe a lista ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--tag	Filtra os resultados por marcas.
--cmd, --command	Filtra os resultados por comando especificado pelo aplicativo.
-n, --count	Limita o número de aplicativos exibidos em uma consulta.
-e, --exact	Usa a cadeia de caracteres exata na consulta de lista, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--scope	Selecione o filtro de escopo do pacote instalado (usuário ou computador).
--header	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--authentication-mode	Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account	Especifique a conta a ser usada para autenticação.
--accept-source-agreements	Usado para aceitar o contrato de licença de origem e evitar o prompt.
--upgrade-available	Lista apenas os pacotes que têm uma atualização disponível.
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--disable-interactivity	Desabilitar prompts interativos.
--proxy	Defina um proxy a ser usado para essa execução.
--no-proxy	Desabilite o uso de proxy para essa execução.

Consultas de exemplo

O exemplo a seguir lista uma versão específica de um aplicativo.

O exemplo a seguir lista todos os aplicativos por ID de uma origem específica.

O exemplo a seguir limita a saída do comando list a nove aplicativos.

List with update

Conforme mencionado acima, o comando list permite que você veja quais aplicativos instalados têm atualizações disponíveis.

Na imagem abaixo, você observará que a versão prévia do Terminal tem uma atualização disponível.

O comando list exibirá não apenas a versão de atualização disponível, mas a origem da qual a atualização está disponível.

Se não houver nenhuma atualização disponível, list mostrará apenas a versão instalada no momento e a coluna de atualização não será exibida.

• Usar a ferramenta winget para listar e gerenciar aplicativos