Partilhar via


comando "list" (winget)

O comando list do WinGet exibe uma lista dos aplicativos atualmente instalados no seu computador. O comando list mostrará os aplicativos que foram instalados por meio do Gerenciador de Pacotes do Windows, bem como os 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ê pode usar o comando upgrade para atualizar o aplicativo.

O comando list também suporta filtros que podem ser usados para limitar sua consulta de lista.

Apelidos

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

  • ls

Utilização

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

Captura de tela listando as opções de comando winget list.

Para listar todos os aplicativos com atualizações disponíveis, use o comando: winget list --upgrade-available (sem argumentos).

Argumentos

Estão disponíveis os seguintes argumentos.

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

Observação

O argumento de consulta é posicional. Não é suportada a sintaxe estilo curinga. Na maioria das vezes, essa é a sequência de caracteres que você espera ajudar a encontrar o pacote instalado que você está procurando.

Opções

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

Opção Descrição
--ID Limita a lista à ID do aplicativo.
--nome Limita a lista ao nome do aplicativo.
--apelido Limita a lista ao apelido listado para o aplicativo.
-s, --fonte Restringe a lista ao nome de origem fornecido. Deve ser seguido pelo nome da fonte.
--etiqueta Filtra os resultados por tags.
--cmd, --comando Filtra os resultados por comando especificado pelo aplicativo.
-n, --contar Limita o número de aplicativos exibidos em uma consulta.
-e, --exacto Usa a cadeia de caracteres exata na consulta de lista, incluindo a verificação de diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--âmbito de aplicação Selecione o filtro de escopo do pacote instalado (usuário ou máquina).
--cabeçalho Cabeçalho HTTP de origem REST opcional para Windows-Package-Manager.
--modo de autenticação Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
--aceitar-acordos-de-fonte Usado para aceitar o contrato de licença original e evitar o aviso.
--upgrade-disponível Lista apenas os pacotes que têm uma atualização disponível.
-u, --desconhecido, --incluir-desconhecido Lista pacotes mesmo que sua versão atual não possa ser determinada.
--fixado, --incluir-fixado Lista pacotes mesmo que eles tenham um pino que impeça atualizações pelo WinGet.
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

Exemplos de consultas

O exemplo a seguir lista os aplicativos instalados com uma determinada substring em seu nome.

Captura de tela do uso do comando winget --list git para todos os aplicativos instalados com o nome git.

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

Captura de tela listando winget list --id Git.Git para mostrar todos os aplicativos instalados provenientes dessa fonte.

O exemplo a seguir limita a saída de lista a 9 aplicações.

Captura de tela listando winget list --count 9 para limitar o número de aplicativos instalados listados a apenas 9.

Lista com atualização

Como dito acima, o comando list permite que você veja quais aplicativos você instalou que têm atualizações disponíveis.

Na imagem abaixo, você notará aplicativos com uma atualização disponível.

Captura de tela listando winget list --upgrade-available para mostrar aplicativos instalados com uma atualização disponível.

O comando lista mostrará não apenas a versão de atualização disponível, mas também a fonte de onde a atualização está disponível.

Se não houver atualizações disponíveis, a lista mostrará apenas a versão atualmente instalada e a coluna de atualização não será exibida.