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>]
Aliases
Os seguintes aliases estão disponíveis para esse comando:
- find
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. |
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
Para mostrar todos os pacotes de winget disponíveis, use o comando:
winget search --query ""
No PowerShell, você precisará escapar das aspas para que esse comando se torne:
winget search -q `"`"
Observação
Esta é uma alteração das versões anteriores do winget com suporte ao winget search sem filtros nem opções que exibem todos os pacotes disponíveis. Também será possível pesquisar todos os aplicativos em outra fonte passando 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. |
| --cmd, --command | Limita a pesquisa aos comandos listados para o 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. 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.
Tópicos relacionados
Windows developer