search Comando (winget)

O search comando de winget pode ser usado para mostrar todas as aplicações 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 search comando inclui parâmetros para filtrar as aplicações devolvidas para ajudar a identificar a aplicação específica que procura, 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 ecrã Windows PowerShell a mostrar os resultados do comando wingetsearch.

Apelidos

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

  • find

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-q, --query O flag de consulta é o argumento padrão usado para search uma aplicação. 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. winget realiza uma correspondência de subcadeia sem distinção entre maiúsculas e minúsculas com o nome, o ID e o moniker do pacote. A sintaxe coringa não é suportada. Utilize -e, --exact para exigir uma correspondência exata e 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

Isto representa uma alteração em relação às versões winget anteriores, que eram suportadas winget search sem filtros ou opções que exibiam todos os pacotes disponíveis. Também pode search para todas as aplicações de outra origem ao passar a opção --source.

Sequências de pesquisa

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

Opção Descrição
--id Limita o search ao ID da aplicação. O ID inclui o editor e o nome do aplicativo.
--name Limita o search ao nome da aplicação.
--moniker Limita o search ao moniker especificado.
--tag Limita o search às tags listadas para a aplicação.
--cmd, --command Limita o search aos comandos listados da aplicação.
-s, --source Encontre o pacote usando o especificado nome do código-fonte.
-n, --count Não mostrar mais do que o número especificado de resultados (entre 1 e 1000).
-e, --exact 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.
--header Cabeçalho HTTP de origem REST opcional para 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 versões disponíveis do pacote.
-?, --help Obtém ajuda adicional sobre este comando.
--wait Solicita que o usuário pressione qualquer tecla antes de sair.
--logs, --open-logs Abra o local de logs padrão.
--verbose, --verbose-logs Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn, --ignore-warnings Suprime mensagens de aviso.
--disable-interactivity Desative os prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desative o uso de proxy para esta execução.

A cadeia de caracteres será tratada como uma substring. O search, por predefinição, também não distingue 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. Este search usa "Visual Studio Code" como consulta.