Partilhar via


comando de download (winget)

O comando de download do WinGet baixa o instalador, as dependências e o arquivo de licença (ao baixar um aplicativo empacotado da Microsoft Store). Use o comando search e o comando show para identificar o instalador de pacotes que você deseja baixar.

O comando download requer que você especifique a cadeia de caracteres exata para download. Se houver alguma ambiguidade, você será solicitado a filtrar ainda mais o comando de download para um aplicativo exato.

O comando de download requer autenticação EntraID (formalmente Azure Ative Directory) para baixar um aplicativo empacotado da Microsoft Store (*.msix, *.appx, *.msixbundle ou *.appxbundle) e para baixar o arquivo de licença de aplicativo empacotado da Microsoft Store. A conta EntraID usada para autenticação para gerar e recuperar um arquivo de licença de aplicativo empacotado da Microsoft Store deve ser membro de uma das três funções do Azure a seguir: Administrador Global, Administrador de Usuário ou Administrador de Licença.

Observação

Por padrão, o comando de download baixará o instalador apropriado para a pasta Downloads do usuário. Use a opção --download-directory para especificar um caminho de download personalizado.

Utilização

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

Captura de tela de inserção do comando winget download em uma linha de comando do Terminal do Windows.

Download sem arquivo de licença

Baixando um pacote usando WinGet, o arquivo de licença do pacote pode ser omitido anexando ao comando o --skip-license parâmetro. A exclusão do arquivo de licença do pacote removerá o requisito de autorização para gerar o arquivo de licença offline.

winget download [[--id] <package id>] [[--skip-license]] [<options>]

Download para uma plataforma específica

O download de um pacote usando o WinGet, por padrão, fará o download da versão mais recente disponível de um pacote para cada caso de uso aplicável (arquitetura, plataforma do dispositivo, etc.). A filtragem do conteúdo baixado para uma plataforma de dispositivo específica é feita anexando ao comando o --platform parâmetro.

winget download [[--id] <package id>] [[--platform] <platform type> ] [<options>]
Plataforma Descrição
Windows.Desktop Suporta a instalação no ambiente de trabalho do Windows
Windows.Universal Permite a instalação em todos os sistemas operativos da Microsoft
Windows.Holográfico Suporta a instalação em dispositivos Microsoft HoloLens

Download para uma arquitetura específica

O download de um pacote usando o WinGet, por padrão, fará o download da versão mais recente disponível de um pacote para cada caso de uso aplicável (arquitetura, plataforma do dispositivo, etc.). A filtragem do conteúdo baixado com uma arquitetura específica é feita anexando ao comando o --architecture parâmetro.

winget download [[--id] <package id>] [[--architecture] <Architecture>] [<options>]
Arquitetura Descrição
x86 Processador de 32 bits
x64 Processador de 64 bits
braço Processador ARM de 32 bits
ARM64 Processador ARM de 64 bits

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 baixar.

Opções

As opções permitem que você personalize a experiência de download para atender às suas necessidades.

Opção Descrição
-d, --download-directory Diretório onde os instaladores são baixados.
-m, --manifest Deve ser seguido pelo caminho para o ficheiro de manifesto (YAML).
--id Limita o download ao ID do aplicativo.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao apelido listado para o aplicativo.
-v, --version Permite especificar uma versão exata para instalar. Se não for especificado, o mais recente baixará o aplicativo com a versão mais alta.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome da fonte.
--scope 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, --architecture Selecione a arquitetura para download.
--installer-type Selecione o tipo de instalador para download.
-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.
--locale Especifica qual localidade usar (formato BCP47).
--ignore-security-hash Ignore a falha de verificação de hash do instalador. Não recomendado.
--skip-dependencies Ignora o processamento das dependências de pacotes e das funcionalidades do Windows.
--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-package-agreements Usado para aceitar o contrato de licença e evitar a mensagem de aviso.
--accept-source-agreements Usado para aceitar o contrato de licença original e evitar o aviso.
--skip-license,--skip-microsoft-store-package-license Ignora a recuperação da licença offline do pacote da Microsoft Store.
--platform Selecione a plataforma de destino.
-?, --help Obtenha 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.

Exemplos de consultas

O exemplo a seguir baixa uma versão específica de um aplicativo através do seu ID.

winget download --id Microsoft.PowerToys --version 0.15.2

O exemplo a seguir baixa um aplicativo com um tipo de instalador específico.

winget download --id Microsoft.WingetCreate --installer-type msix

O exemplo a seguir baixa um aplicativo por arquitetura e escopo para um diretório de download específico.

winget download --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory <Path>