Comando search (winget)

O comando search da ferramenta 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 retorna todos os aplicativos disponíveis que incluem "vscode" na descrição ou na marca.

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

Screenshot of the Windows Power Shell window displaying the results of the winget search.

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento 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.
-?, --help Obtém ajuda adicional sobre esse comando.

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

Se o comando search não incluir filtros nem opções, ele exibirá todos os aplicativos disponíveis na origem padrão. Também será possível pesquisar todos os aplicativos em outra fonte se passar apenas 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.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker especificado.
--tag Limita a pesquisa às tags listadas para o aplicativo.
--command Limita a pesquisa aos comandos listados para o aplicativo.
--verbose-logs Usado para substituir a configuração de registro em log e criar um log detalhado.
-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.
-n, --count Mostrar apenas o número especificado de resultados (entre 1 e 1000).
-s, --source Localizar o pacote usando o nome de origem especificado.
--header O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--accept-source-agreements Aceitar todos os contratos de licença de origem e evitar o prompt.

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
  • Microscope
  • MyMicro

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.