list comando (winget)

O list comando do WinGet exibe um list dos aplicativos atualmente instalados no seu computador. O comando list mostrará aplicativos que foram instalados por meio do Windows Gerenciador de Pacotes, bem como aplicativos que foram instalados por outros meios.

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

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

Apelidos

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

  • ls

Uso

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

Captura de tela listando wingetlist opções de comando.

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

Argumentos

Os argumentos a seguir estão disponíveis.

Argument 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 personalizar a list experiência para atender às suas necessidades.

Opção Descrição
--id Limita o list ao ID do aplicativo.
--nome Limita o list ao nome do aplicativo.
--moniker Limita o list ao moniker listado para o aplicativo.
-s, --fonte Restringe o list ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--etiqueta Filtra os resultados por marcas.
--cmd, --comando Filtra os resultados por comando especificado pelo aplicativo.
-n, --count Limita o número de aplicativos exibidos em uma consulta.
-e, --exact Usa a string exata na consulta list, incluindo a verificação de distinção entre 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).
--conta-de-autenticação 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.
-u, --unknown, --include-unknown Lista pacotes mesmo que sua versão atual não possa ser determinada.
--pinned,--include-pinned Lista os pacotes mesmo se eles tiverem um pin que impeça atualizações pelo WinGet.
--Detalhes Exibe uma saída detalhada, semelhante a show, para cada pacote correspondente, em vez de uma exibição em tabela.
-?--Ajuda Obtêm ajuda adicional sobre esse comando.
--esperar 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 aplicativos instalados com uma determinada subcadeia de caracteres em seu nome.

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

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

Captura de tela listando wingetlist --id Git.Git para mostrar todos os aplicativos instalados provenientes dessa origem.

O exemplo a seguir limita a saída de list a 9 aplicativos.

Captura de tela mostrando wingetlist --count 9 para limitar a lista de aplicativos instalados a apenas 9.

Lista com atualização

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

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

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

O list comando mostrará 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 atualizações disponíveis, list mostrará apenas a versão instalada no momento e a coluna de atualização não será exibida.

Lista com detalhes

O exemplo a seguir lista os detalhes de um aplicativo instalado por seu identificador.

Captura de tela mostrando wingetwingetlist --id Microsoft.VisualStudioCode --details para exibir detalhes do aplicativo instalado