Compartilhar via


Comando search (winget)

O comando de pesquisa do WinGet pode ser usado para mostrar todos os aplicativos disponíveis para instalação. Ele também pode ser usado para identificar a cadeia de caracteres ou a ID necessária para instalar um aplicativo específico.

Por exemplo, o comando winget search vscode retornará todos os aplicativos disponíveis que incluem "vscode" no nome, id, descrição, moniker ou marcas.

O comando search inclui parâmetros que filtram os aplicativos retornados para que você identifique o aplicativo específico que está procurando, como: --id, --name, --moniker, --tag, --command ou --source. Veja as descrições abaixo ou use winget search --help na linha de comando.

Uso

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

Captura de tela do Windows PowerShell exibindo os resultados do comando de pesquisa winget.

Apelidos

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

  • localizar

Argumentos

Os argumentos a seguir estão disponíveis.

Argument Descrição
-q,--query O sinalizador de consulta é o argumento padrão usado para procurar um aplicativo. Ele não precisa ser especificado. A inserção do comando winget search foo usará --query como padrão, portanto, é desnecessário incluí-lo.

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 que você está procurando.

Mostrar tudo

Para mostrar todos os pacotes de winget disponíveis, use o comando:

winget search --query ""

No Windows PowerShell, você precisará escapar das aspas para que este comando se torne:

winget search -q `"`"

Observação

Esta é uma alteração das versões anteriores do winget com suporte ao winget search sem filtros nem opções que exibem todos os pacotes disponíveis. Também será possível pesquisar todos os aplicativos em outra fonte passando a opção de origem.

Cadeias de caracteres de pesquisa

As cadeias de caracteres de pesquisa podem ser filtradas com as opções a seguir.

Opção Descrição
--id Limita a pesquisa à ID do aplicativo. A ID inclui o editor e o nome do aplicativo.
--nome Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker especificado.
--etiqueta Limita a pesquisa às tags listadas para o aplicativo.
--cmd, --comando Limita a pesquisa aos comandos listados para o aplicativo.
-s, --fonte Localizar o pacote usando o nome de origem especificado.
-n, --count Mostrar apenas o número especificado de resultados (entre 1 e 1000).
-e, --exact Usa a cadeia de caracteres exata na consulta, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--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 Aceite todos os contratos de origem durante as operações de origem.
--Versões Mostrar as versões disponíveis do pacote.
-?, --help 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.

A cadeia de caracteres será tratada como uma substring. A pesquisa, por padrão, também não diferencia maiúsculas de minúsculas. Por exemplo, winget search micro poderia retornar o seguinte:

  • Microsoft
  • Microscópio
  • MinhaMicro

Pesquisando em várias fontes

Se você deseja restringir os resultados a uma fonte específica, basta passar o parâmetro --source ou -s e especificar o que deseja. Por exemplo, talvez você queira ver se o Visual Studio Code está disponível executando winget search “Visual Studio Code” -s msstore. Essa pesquisa usa "Visual Studio Code" como a consulta.