Compartilhar via


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

Imagem do uso do comando list

Observação

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.

Observação

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.

comando list name

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

comando list id with source

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

comando list count

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.

Imagem do comando list with update

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.