Partilhar via


comando de pesquisa (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 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, apelido ou tags.

O comando search 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, --command, ou --source. Veja as descrições abaixo ou use winget search --help em sua linha de comando.

Utilização

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

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

Apelidos

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

  • Encontrar

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-q,--query O sinalizador de consulta é o argumento padrão usado para pesquisar um aplicativo. Não é necessário especificá-lo. Inserir o comando winget search foo definirá por padrão o uso de --query, portanto, incluí-lo é desnecessário.

Observação

O argumento de consulta é posicional. Não é suportada a sintaxe estilo curinga. Esta é, na maioria das vezes, a sequência de caracteres que você espera ajudar a encontrar o pacote que está procurando.

Mostrar tudo

Para mostrar todos os pacotes 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 mudança em relação às versões anteriores do winget que suportavam winget search sem filtros ou opções exibindo todos os pacotes disponíveis. Você também pode pesquisar todas as aplicações numa outra fonte ao passar a opção de origem.

Sequências de pesquisa

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

Opção Descrição
--ID Limita a pesquisa ao ID do aplicativo. O ID inclui o editor e o nome do aplicativo.
--nome Limita a pesquisa ao nome do aplicativo.
--apelido Limita a pesquisa ao apelido especificado.
--etiqueta Limita a pesquisa às tags listadas para o aplicativo.
--cmd, --comando Limita a pesquisa aos comandos listados para o aplicativo.
-s, --fonte Encontre o pacote usando o especificado nome do código-fonte.
-n, --contar Não mostrar mais do que o número especificado de resultados (entre 1 e 1000).
-e, --exatos Usa a cadeia de caracteres exata na consulta, incluindo a verificação de diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--cabeçalho Cabeçalho HTTP de origem REST opcional para Windows-Package-Manager.
--modo de autenticação Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
--aceitar-acordos-de-fonte Aceite todos os contratos de origem durante as operações de origem.
--versões Mostrar versões disponíveis do pacote.
-?, --ajuda Obtém ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta 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:

  • A Microsoft
  • Microscópio
  • MyMicro

Pesquisa em várias fontes

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