Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O comando install do WinGet instala o aplicativo especificado. Use o comando search para identificar o aplicativo que você deseja instalar. Use o comando show para visualizar detalhes sobre o aplicativo e o instalador selecionado pelo WinGet para o seu sistema.
O comando install requer que você especifique a cadeia de caracteres exata a ser instalada. Se houver alguma ambiguidade, você será solicitado a filtrar ainda mais o comando install para um aplicativo exato.
Utilização
winget install [[-q] <query> ...] [<options>]
Apelidos
Os seguintes aliases estão disponíveis para este comando:
- adicionar
Argumentos
Estão disponíveis os seguintes argumentos.
| Argumento | Descrição |
|---|---|
| -q,--query | A consulta usada para procurar um aplicativo. |
Observação
O argumento de consulta é posicional. Não é suportada a sintaxe estilo curinga. Na maioria das vezes, essa é a sequência de caracteres que você espera identificar exclusivamente o pacote que deseja instalar.
Opções
As opções permitem que você personalize a experiência de instalação para atender às suas necessidades.
| Opção | Descrição |
|---|---|
| -m, --manifesto | Deve ser seguido pelo caminho para o ficheiro de manifesto (YAML). Você pode usar o manifesto para executar a experiência de instalação a partir de um arquivo YAML local. |
| --ID | Limita a instalação à ID do aplicativo. |
| --nome | Limita a pesquisa ao nome do aplicativo. |
| --apelido | Limita a pesquisa ao apelido listado para o aplicativo. |
| -v, --versão | Permite especificar uma versão exata para instalar. Se não for especificado, o mais recente instalará o aplicativo com a versão mais alta. |
| -s, --fonte | Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome da fonte. |
| --âmbito de aplicação | Permite especificar se o instalador deve ter como alvo o escopo do usuário ou da máquina. Consulte os problemas conhecidos relacionados ao escopo de instalação do pacote. |
| -a, --arquitetura | Selecione a arquitetura a ser instalada. |
| --tipo de instalador | Selecione o tipo de instalador a ser instalado. Consulte os tipos de instalador suportados para o cliente WinGet. |
| -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. |
| -i, --interativo | Executa o instalador no modo interativo. A experiência padrão mostra o progresso do instalador. |
| -h, --silencioso | Executa o instalador no modo silencioso. Isso suprime toda a interface do usuário. A experiência padrão mostra o progresso do instalador. |
| --localidade | Especifica qual localidade usar (formato BCP47). |
| -o, --log | Direciona o registo para um ficheiro de log. Você deve fornecer um caminho para um arquivo para o qual tenha os direitos de gravação. |
| -- personalizado | Argumentos a serem passados para o instalador, além dos padrões. |
| --anular | Uma cadeia de caracteres que será passada diretamente para o instalador. |
| -l, --localização | Local para instalar (se suportado). |
| --ignorar-hash-de-segurança | Ignore a falha de verificação de hash do instalador. Não recomendado. |
| --allow-reboot | Permite uma reinicialização, se aplicável. |
| --skip-dependências | Ignora o processamento das dependências de pacotes e das funcionalidades do Windows. |
| --ignorar-verificação-de-malware-no-arquivo-local | Ignore a verificação de malware executada como parte da instalação de um pacote de tipo arquivo a partir do manifesto local. |
| --source-dependência | Encontre dependências de pacotes usando a fonte especificada. |
| --aceitar-acordos-de-pacotes | Usado para aceitar o contrato de licença e evitar a mensagem de aviso. |
| --sem atualização | Ignora a atualização se já existir uma versão instalada. |
| --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 | Usado para aceitar o contrato de licença original e evitar o aviso. |
| -r, --renomear | O valor para renomear o arquivo executável (portátil). |
| --desinstalar-versão-anterior | Desinstale a versão anterior do pacote durante a atualização. |
| --força | Execute de forma direta o comando e continue com questões não relacionadas à segurança. |
| -?, --ajuda | Obtenha 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. |
Exemplos de consultas
O exemplo a seguir instala uma versão específica de um aplicativo.
winget install powertoys --version 0.91.1
O exemplo a seguir instala um aplicativo a partir de sua ID.
winget install --id Microsoft.PowerToys
O exemplo a seguir instala um aplicativo por versão e ID.
winget install --id Microsoft.PowerToys --version 0.91.1
Seleções múltiplas
Se a consulta fornecida ao WinGet não resultar em um único aplicativo, o WinGet exibirá os resultados da pesquisa. Isso fornecerá os dados adicionais necessários para refinar a busca por uma instalação correta.
A melhor maneira de limitar a seleção a um arquivo é usar o de ID de
winget install --id Git.Git -e
Se várias fontes estiverem configuradas, é possível ter entradas duplicadas. Especificar uma fonte é necessário para desambiguar ainda mais.
winget install --id Git.Git -e --source winget
O msstore fonte usa identificadores exclusivos como o "Id" para pacotes. Estes não requerem a opção de consulta exata . Por exemplo:
winget install XP9KHM4BK9FZ7Q -s msstore
Você também pode usar o comando install para instalar vários pacotes. Por exemplo:
winget install Microsoft.Edit Microsoft.NuGet
Instalação local
A opção manifesto permite que você instale um aplicativo passando um arquivo YAML diretamente para o cliente. Se o manifesto for um manifesto de vários arquivos, o diretório que contém os arquivos deve ser usado. A opção manifesto tem o seguinte uso.
Utilização: winget install --manifest \<path>
| Opção | Descrição |
|---|---|
| -m, --manifesto | O caminho para os manifestos do aplicativo a ser instalado. |
A instalação de pacotes a partir de arquivos de manifesto locais pode ter riscos. Como medida extra de precaução, esse recurso precisa ser habilitado por um administrador. Para habilitar esse recurso, execute winget settings --enable LocalManifestFiles. Para desativar esse recurso, execute winget settings --disable LocalManifestFiles.
Ficheiros de registo
Os arquivos de log do WinGet, a menos que sejam redirecionados, estarão localizados na seguinte pasta: \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.log
Contratos de Licença
Alguns aplicativos, quando instalados, exigirão que o usuário concorde com a licença ou outros contratos antes da instalação. Quando isso ocorrer, o Gerenciador de Pacotes do Windows solicitará que o usuário concorde com os contratos. Se o usuário não concordar, o aplicativo não será instalado.
Na linha de comando, você pode aceitar automaticamente os contratos passando a seguinte opção --accept-package-agreements na linha de comando. Isso pode ser benéfico ao criar scripts para o Gerenciador de Pacotes do Windows.
Tópicos relacionados
Colabore connosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever issues e pull requests. Para mais informações, consulte o nosso guia para colaboradores.
Windows developer