search comando (winget)

O comando search do winget pode ser usado para exibir 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>]

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 com distinção entre maiúsculas e minúsculas. Use --id, --name ou --moniker para restringir em qual campo a pesquisa é feita.

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 passando 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.
--name	Limita o search ao nome do aplicativo.
--moniker	Limita o search ao moniker especificado.
--tag	Limita o search às tags listadas para o aplicativo.
--cmd, --command	Limita o search aos comandos listados do aplicativo.
-s, --source	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).
--authentication-account	Especifique a conta a ser usada para autenticação.
--accept-source-agreements	Aceite todos os contratos de origem durante as operações de origem.
--versions	Mostrar as versões disponíveis do pacote.
-?, --help	Obtém ajuda adicional sobre esse comando.
--wait	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.

Tópicos relacionados:

• Usar a winget ferramenta para instalar e gerenciar aplicativos