search comando (winget)

O search comando 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 search comando inclui parâmetros para filtrar os aplicativos retornados para ajudá-lo a identificar o aplicativo específico que você está procurando, incluindo: --id, , --name, --moniker, --tag, --commandou --source. Veja as descrições abaixo ou use winget search --help na linha de comando.

Uso

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

Screenshot Windows PowerShell exibindo os resultados do wingetsearch command.

Apelidos

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

  • find

Argumentos

Os argumentos a seguir estão disponíveis.

Argument Descrição
-q,--query O sinalizador de consulta é o argumento padrão usado para search 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. winget realiza uma correspondência de substring sem diferenciar maiúsculas de minúsculas com o nome do pacote, o ID e o nome alternativo. Não há suporte para sintaxe curinga. Use -e, --exact para exigir uma correspondência exata, sensível a maiúsculas e minúsculas. Use --id, --name ou --moniker para restringir qual campo é pesquisado.

Mostrar tudo

Para mostrar todos os winget pacotes 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 mudança em relação às versões anteriores de winget, que ofereciam suporte a winget search sem filtros ou opções, exibindo todos os pacotes disponíveis. Você também pode search para todos os aplicativos em outra origem ao passar a opção source.

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 o search ao ID do aplicativo. A ID inclui o editor e o nome do aplicativo.
--nome Limita o search ao nome do aplicativo.
--moniker Limita o search ao moniker especificado.
--etiqueta Limita o search às tags listadas para o aplicativo.
--cmd, --comando Limita o search aos comandos listados do 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.
-?--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.

A cadeia de caracteres será tratada como uma substring. O search 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. Este search usa "Visual Studio Code" como a consulta.