Opções de linha de comando da Instalação do Windows
As opções de linha de comando a seguir estão disponíveis para a Instalação do Windows (setup.exe). A partir do Windows 10, versão 1607, você pode usar um arquivo setupconfig como uma alternativa para passar parâmetros para a Instalação do Windows em uma linha de comando. Para obter mais informações, consulte Visão geral da automação da Instalação do Windows.
/1394Debug
Habilita a depuração do kernel em uma porta IEEE 1394 (FireWire) enquanto o Windows está em execução e durante o passo de configuração WindowsPE da Instalação do Windows.
Sintaxe
/1394Debug:<channel> [BaudRate:<baudrate>]
Exemplos
setup /1394debug:1 /baudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
O valor padrão para <canal> é 1. <baudrate> especifica o baud a ser usado quando o Windows transfere dados durante a depuração. O valor padrão é 19200, mas também pode ser definido como 57600 ou 115200.
/AddBootMgrLast
Instrui a Instalação do Windows a adicionar o Gerenciador de Inicialização do Windows como a última entrada na ordem de inicialização do firmware UEFI.
Sintaxe
/AddBootMgrLast
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 e superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Esta opção só é suportada em PCs UEFI com o Windows PE 4.0 ou posterior.
/Auto
Executa uma atualização automatizada para uma versão mais recente do Windows.
Sintaxe
/Auto {Clean | DataOnly | Upgrade}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Clean | Executa uma instalação limpa do Windows. |
| DataOnly | Executa uma atualização do Windows, salvando apenas dados (e não aplicativos). Se a opção de instalação somente dados não estiver disponível devido a verificações de compatibilidade, a Instalação do Windows será encerrada silenciosamente e registrará um código de saída. |
| Atualizar | Executa uma atualização do Windows salvando aplicativos e dados. Se a opção de instalação de atualização não estiver disponível ou o usuário precisar resolver um problema de compatibilidade de aplicativos, a Instalação do Windows será encerrada silenciosamente e registrará um código de saída. A partir do Windows 11, versão 22H2, especificar a opção Upgrade requer que a mídia de instalação tenha o mesmo idioma da interface do usuário padrão do sistema que o dispositivo de destino. Em versões anteriores do Windows, você podia executar algumas implantações entre idiomas (por exemplo, en-US para en-GB), mas esses tipos de atualizações não são mais permitidos. |
| NoAutoEit | Não usado a partir do Windows 10. No Windows 8.1, se um erro for encontrado, a Instalação do Windows não será encerrada, mas interromperá e permanecerá na tela de Instalação do Windows até que o usuário resolva o problema. A instalação a partir desse ponto é atendida. |
| PerformDU | Não usado a partir do Windows 10. No Windows 8.1, a Instalação do Windows verifica se há atualizações dinâmicas para a Instalação do Windows |
Exemplos
setup /auto clean
setup /auto dataonly
setup /auto upgrade
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Quando /Auto é usado, um arquivo autônomo não pode ser usado. Quando /Auto é usado, a Instalação do Windows consome ei.cfg e verifica problemas de compatibilidade antes de iniciar a instalação. Se ei.cfg estiver malformado, a Instalação do Windows será encerrada silenciosamente e registrará um código de saída. Consulte Códigos de saída da Instalação do Windows abaixo. Quando /Auto é usado, somente as personalizações a seguir da imagem do Windows são suportadas. Esta não é uma alteração na política de suporte da Instalação do Windows, mas sim uma clarificação:
- Aplicando uma atualização cumulativa (de qualidade)
- Aplicando atualizações à pilha de serviços necessárias para concluir a atualização de recursos (consulte Atualizações da pilha de manutenção para obter mais informações)
- Aplicando atualizações à Setup.exe binários ou outros arquivos que a Instalação usa para atualizações de recursos
- Aplicando atualizações para o "sistema operacional seguro" (SafeOS) que é usado para o ambiente de recuperação do Windows
- Adicionar ou remover idiomas
- Adicionar ou remover Recursos sob Demanda
Para maior clareza, quando /Auto é usado, a Instalação do Windows não oferece suporte a atualizações nem instalações limpas para uma imagem do Windows que foi personalizada adicionando / removendo / alterando aplicativos, configurações ou drivers.
Quando /Auto é usado, a Instalação do Windows atualizará usando a imagem do Windows \sources\install.wim. Usando Dism /Export-Image, essa imagem pode ser usada como uma imagem de origem para exportar uma nova imagem usando a opção /Compress:recovery. Essa imagem exportada deve ser chamada install.esd para que a Instalação do Windows a use em vez de install.wim. Você também deve remover install.wim de \sources. Você só deve exportar para install.esd se quiser reduzir o tamanho da imagem do Windows. A imagem exportada será menor, mas não poderá ser montada.
A partir do Windows 11, o /Auto não aceitará nem substituirá o contrato de licença do usuário final. Ver /EULA.
/BitLocker
Especifica o status do BitLocker durante as atualizações.
Sintaxe
/BitLocker {AlwaysSuspend | TryKeepActive | ForceKeepActive}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| AlwaysSuspend | O BitLocker é sempre suspenso durante uma atualização. |
| TryKeepActive | Tenta uma atualização sem suspender o BitLocker. Se a atualização falhar, a Instalação do Windows suspenderá o BitLocker e concluirá a atualização. Esse é o comportamento padrão se a opção /BitLocker não for especificada. |
| ForceKeepActive | Habilita a atualização sem suspender o BitLocker. Se a atualização não puder ser concluída porque o BitLocker está ativo, a atualização falhará. |
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
/BusParams
Especifica o endereço PCI de uma porta de depuração 1394, USB ou NET.
Sintaxe
/BusParams:<bus.device.function>
Exemplos
setup /busparams:0.29.7
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Os números bus, device e function devem estar no formato decimal. Para obter mais informações, consulte Configurando a depuração do kernel com USB 2.0.
/ConfigFile
Especifica o local para o arquivo setupconfig.
Sintaxe
/ConfigFile:<location>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho do arquivo local ou caminho de rede UNC para uma pasta que contém o arquivo de configuração da Instalação do Windows. |
Exemplos
setup /ConfigFile:\\server\share\
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Se você incluir uma opção na linha de comando e a mesma opção no arquivo setupconfig, a opção e o valor do arquivo setupconfig terão precedência.
/CompactOS
Especifica se o recurso Compact OS deve ser usado para economizar espaço no disco rígido.
Sintaxe
/CompactOS {Enable | Disable}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | A Instalação do Windows instala o Windows usando arquivos de sistema compactados. |
| Desabilitar | A Instalação do Windows instala o Windows usando arquivos de sistema descompactados. |
Exemplos
setup /compactos enable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Por padrão, a Instalação do Windows determina se esse recurso deve ser usado automaticamente. Para saber mais sobre o sistema operacional compacto, consulte sistema operacional compacto, instanciação única e otimização de imagem.
/Compat
Instrui a Instalação do Windows como lidar com varreduras e mensagens de compatibilidade.
Sintaxe
/Compat {IgnoreWarning | ScanOnly}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| IgnoreWarning | A Instalação do Windows conclui a instalação, ignorando quaisquer mensagens de compatibilidade descartáveis. |
| ScanOnly | A Instalação do Windows é executada por meio de varreduras de compatibilidade e, em seguida, sai (sem concluir a instalação) com um código de saída para indicar se há problemas de compatibilidade. A Instalação do Windows retornará 0xC1900210 se nenhuma preocupação for encontrada. A Instalação do Windows retornará 0xC1900208 se forem encontradas preocupações de compatibilidade. |
Exemplos
setup /compat ignorewarning
Este comando funciona com outras opções. Para executar a Instalação do Windows em segundo plano sem qualquer interface do usuário:
setup /auto upgrade /quiet /compat scanonly
Para ignorar isenções de responsabilidade comuns na interface do usuário, por exemplo, alterações de idioma:
setup /auto upgrade /quiet /compat scanonly /compat ignorewarning
Muitas vezes, um profissional de TI examinará o XML de compatibilidade se a Instalação do Windows encontrar problemas de compatibilidade. Use /CopyLogs para coletar logs da Instalação do Windows:
setup /auto upgrade /quiet /compat scanonly /compat ignorewarning /copylogs C:\Temp\Logfiles.log
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim, apenas com /Compat IgnoreWarning |
Comentários
Esta opção está disponível a partir do Windows 10 e superior.
Se você iniciar a Instalação do Windows com o /Compat ScanOnly:
- Se não encontrar nenhum problema de compatibilidade, ele retornará MOSETUP_E_COMPAT_SCANONLY (0xC1900210)
- Se encontrar problemas de compatibilidade acionáveis, como Aplicativos, ele retornará MOSETUP_E_COMPAT_INSTALLREQ_BLOCK (0xC1900208)
- Se descobrir que o Mig-Choice selecionado não está disponível, ele retornará MOSETUP_E_COMPAT_MIGCHOICE_BLOCK (0xC1900204)
- Se descobrir que a máquina não é elegível para o Windows 10 ou superior, ele retornará MOSETUP_E_COMPAT_SYSREQ_BLOCK (0xC1900200)
- Se achar que a máquina não tem espaço livre suficiente para instalar, ele retornará MOSETUP_E_INSTALLDISKSPACE_BLOCK (0xC190020E)
/CopyLogs
A Instalação do Windows copiará ou carregará logs compactados em caso de falha no local especificado, supondo que a máquina/usuário tenha permissão e acesso de rede ao local.
Sintaxe
/CopyLogs <location>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho de arquivo local ou caminhos de rede UNC. |
Exemplos
setup /copylogs \\server\share\
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Os parâmetros aceitos são caminhos de arquivo locais e caminhos de rede UNC. A execução é executada no contexto do sistema, portanto, talvez não tenha permissões para copiar para locais que exigem permissões de usuário.
Debug/
Habilita a depuração do kernel em uma porta COM (comunicações) quando o Windows está em execução e durante o passo de configuração do WindowsPE da Instalação do Windows.
Sintaxe
/Debug:<port> [BaudRate:<baudrate>]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <porta> | Especifica a porta de depuração. O valor padrão é 1. |
| <baudrate> | Especifica o baud a ser usado quando o Windows transfere dados durante a depuração. A configuração padrão é 19200, mas também pode ser definida como 57600 ou 115200. |
Exemplos
setup /debug:1 /baudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
/DiagnosticPrompt
Especifica que o prompt de comando está disponível durante a instalação do Windows.
Sintaxe
/DiagnosticPrompt {Enable | Disable}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | O prompt de comando pode ser acessado pressionando Shift+F10 durante a instalação do Windows. |
| Desabilitar | O prompt de comando não está disponível durante a instalação do Windows. O prompt de comando não estará disponível enquanto as fases offline e OOBE estiverem em execução. Esta é a configuração padrão. |
Exemplos
setup /diagnosticprompt enable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10, versão 1703.
/DynamicUpdate
Especifica se a Instalação do Windows executará operações de Atualização Dinâmica (pesquisa, download e instalação de atualizações).
Sintaxe
/DynamicUpdate {Enable | Disable | NoDrivers | NoLCU | NoDriversNoLCU}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | As operações de Atualização Dinâmica são executadas. |
| Desabilitar | As operações de Atualização Dinâmica não são executadas. |
| NoDrivers | As operações de Atualização Dinâmica são executadas, exceto a aquisição de driver. |
| NoDriversNoLCU | As operações de Atualização Dinâmica são executadas, exceto o driver e a aquisição de atualização cumulativa mais recente. |
| NoLCU | As operações de Atualização Dinâmica são executadas, exceto a aquisição de atualização cumulativa mais recente. |
Exemplos
setup /auto upgrade /dynamicupdate disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim para atualizações de recursos baseadas no Microsoft Update (MU); Sim para atualizações de recursos baseadas em UUP (Unified Updated Platform) somente quando /DynamicUpdate NoDrivers é especificado |
Comentários
NoDrivers, NoLCU e NoDriversNoLCU são novos para o Windows 10, versão 2004. Quando NoDrivers, NoLCU ou NoDriversNoLCU for especificado, as operações de Atualização Dinâmica serão executadas, mas os drivers e/ou a aquisição de atualização cumulativa mais recente não serão executadas. /DynamicUpdate pode ser usado com /SkipFinalize para controlar operações de Atualização Dinâmica; /DynamicUpdate é ignorado quando usado com /Finalize.
/EMSPort
Habilita ou desabilita os Serviços de Gerenciamento de Emergência (EMS) durante a Instalação do Windows e após a instalação do sistema operacional do servidor.
Sintaxe
/EMSPort: {COM1 | COM2 | UseBIOSSettings | Off} [/EMSBaudRate:<baudrate>]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| COM1 | Habilita o EMS sobre COM1. Suportado apenas para sistemas x86. |
| COM2 | Habilita o EMS sobre COM2. Suportado apenas para sistemas x86. |
| UseBIOSSettings | usa a configuração especificada pelo BIOS. Para sistemas x86, o Windows usa o valor da tabela SPCR (Redirecionamento de Console de Porta Serial). Se nenhuma tabela SPCR ou caminho de dispositivo de console EFI for especificado no BIOS, o Windows desabilitará o EMS. |
| Desativado | Desativa o EMS. Se o EMS estiver desabilitado na Instalação do Windows, você poderá habilitar o EMS posteriormente modificando as configurações de inicialização. |
| <baudrate> | Especifica o baud a ser usado quando o Windows transfere dados durante a depuração. O valor padrão é 19200, mas também pode ser definido como 57600 ou 115200. |
Exemplos
setup /emsport:COM1 /emsbaudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
/EULA
Instruções Instalação do Windows para suprimir a experiência do usuário do contrato de licença de usuário final da Instalação do Windows.
Sintaxe
/EULA aceitar
Exemplos
setup /auto upgrade /quiet /eula accept
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção é nova a partir do Windows 11. Especificar /EULA accept instrui a Instalação do Windows de que o contrato de licença de usuário final foi aceito. A partir do Windows 11, a aceitação do EULA do Windows é necessária antes do início da instalação da Instalação do Windows. Ao especificar /EULA accept você concorda que, ao aplicar este sistema operacional, (1) a licença aplicável do Windows foi adquirida por meio de licenciamento por volume ou (2) que você está aceitando os Termos de Licença para Software Microsoft relevantes. A Instalação do Windows retornará o erro MOSETUP_E_EULA_ACCEPT_REQUIRED (0xC190010E) se /EULA accept não for especificado e (1) /Quiet for especificado, ou (2) se a Instalação do Windows for iniciada onde a interação do usuário não é suportada. Para saber mais sobre licenciamento, consulte Termos de Licença da Microsoft.
/Finalize
Instrui a Instalação do Windows para concluir as operações de atualização iniciadas anteriormente no sistema operacional de nível inferior, seguido por uma reinicialização imediata para iniciar a fase offline.
Sintaxe
/Finalize
Exemplos
setup /auto upgrade /finalize
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Esta opção é nova para o Windows 10, versão 2004. /Finalize não deve ser especificado com a opção /NoReboot. A Instalação do Windows retornará o erro MOSETUP_E_FINALIZE_RESUME_FAILURE (0xC1900132) se /Finalize for chamado e o dispositivo não estiver no estado adequado para continuar após a execução de /SkipFinalize. Consulte /SkipFinalize.
/ImageIndex
Instrui a Configuração do Windows qual imagem do sistema operacional instalar a partir de install.wim se várias imagens podem ser aplicáveis.
Sintaxe
/ImageIndex <index>
Exemplos
setup.exe /auto upgrade /quiet /compat ignorewarning /imageindex 2 /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim para atualizações de recursos baseadas no Microsoft Update (MU); Não para atualizações de recursos baseadas na Plataforma Unificada Atualizada (UUP) |
Comentários
Se várias imagens forem aplicáveis, a Instalação do Windows solicitará que o usuário selecione. Se várias imagens forem aplicáveis e a Instalação do Windows for invocada com /Quiet, a Instalação do Windows falhará com o erro MOSETUP_E_NO_MATCHING_INSTALL_IMAGE (0xC1900215). Isso pode ocorrer quando a chave do produto especificada usando /PKey se aplica a várias imagens do sistema operacional.
/InstallDrivers
Adiciona drivers de estilo .inf à nova instalação do Windows 10.
Sintaxe
/InstallDrivers <location>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho de arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .inf. |
Exemplos
setup.exe /auto upgrade /installdrivers C:\Fabrikam\drivers /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção é nova a partir do Windows 10. O driver .inf pode estar em uma pasta dentro do local especificado. O comando será recorrente através do local especificado.
/InstallFrom
Especifica um arquivo Install.wim diferente a ser usado durante a Instalação do Windows.
Sintaxe
/InstallFrom<path>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <caminho> | O caminho do arquivo .wim a ser instalado. |
Exemplos
setup /installfrom D:\custom.wim
Essa opção também pode ser usada com arquivos de imagem divididos (.swm). Selecione o primeiro arquivo de imagem dividida da série
setup /installfrom D:\install.swm
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Isso permite que você use um único ambiente de pré-instalação para instalar várias versões de imagens do Windows. Por exemplo, você pode usar uma versão de 32 bits da Instalação do Windows para implantar uma imagem do Windows de 64 bits. Você também pode usar um arquivo de resposta para implantações entre plataformas. Para mais informações, consulte "Criando um WIM para vários tipos de arquitetura" em Plataformas com suporte da Instalação do Windows e implantações entre plataformas
/InstallLangPacks
Adiciona pacotes de idiomas (lp.cab) à nova instalação do Windows 10 ou superior.
Sintaxe
/InstallLangPacks <location>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho de arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .inf. |
Exemplos
setup /auto upgrade /installlangpacks C:\Fabrikam\Languages\French /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim para atualizações de recursos baseadas no Microsoft Update (MU); Não para atualizações de recursos baseadas na Plataforma Unificada Atualizada (UUP) |
Comentários
Esta opção é nova a partir do Windows 10. Os pacotes de idiomas podem estar em uma pasta dentro do <local> especificado. O comando instala todos os arquivos lp.cab e recursos de idioma, como reconhecimento de conversão de texto em fala, na pasta e subpastas no <local> especificado. Os recursos de idioma podem ter dependido de outros recursos de idioma. Por exemplo, a conversão de texto em fala depende do componente Básico do mesmo idioma. Os recursos de idioma não devem ser renomeados dentro do <local>. Consulte Recursos sob demanda de idioma e região (FOD). No Windows 10, versão 1903 e posterior, as falhas de instalação farão com que a Instalação do Windows falhe e reverta.
/m
Instrui a Instalação do Windows a copiar arquivos alternativos de um local alternativo. Essa opção instrui a Instalação do Windows a procurar primeiro no local alternativo e, se houver arquivos, usá-los em vez dos arquivos do local padrão.
Sintaxe
/m:<folder_name>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <folder_name> | Nome e o local da pasta que contém os arquivos de substituição e pode ser qualquer local da unidade local. Não há suporte para caminhos UNC. |
Exemplos
Para copiar um arquivo C:\Program Files\Messenger\Msmsgs.exe atualizado para a instalação do Windows, crie a seguinte estrutura de pastas na origem de instalação Pro\Sources$OEM$$Progs\Messenger\Msmsgs.exe usando o comando de Instalação:
Pro\sources\setup.exe /m
Se você substituir um arquivo que a proteção de arquivos do Windows protege, também deverá copiar o arquivo atualizado para as fontes locais a serem instaladas com o Windows. Por exemplo, você pode copiar o arquivo para a pasta C:\Windows\i386. O nome do arquivo deve ser o mesmo que o nome usado na Instalação do Windows. Por exemplo, adicione a seguinte estrutura de arquivos e pastas ao diretório $OEM$: Pro\sources$OEM$$$\i386\msmsgs.ex_. Se você usar arquivos que não estão em um compartilhamento de instalação, deverá especificar o nome da pasta. Neste exemplo, o <folder_name> é C:\additional_files, onde C:\additional_files é o diretório $OEM$ personalizado. Por exemplo: C:\additional_files$$\i386\msmsgs.ex_.
setup /m:C:\additional_files
Se você alterar recursos em seus arquivos de substituição, você deve adicionar os arquivos MUI (Multilanguage User Interface) atualizados para a instalação.
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Você deve saber onde os arquivos serão instalados na instalação do Windows. Todos os arquivos adicionais devem ser copiados para uma pasta $OEM$ nas fontes de instalação ou no <folder_name>. A estrutura $OEM$ fornece uma representação do disco de instalação de destino:
- $OEM$\$1 mapeia para %SYSTEMDRIVE%, que pode ser a unidade C.
- $OEM$\$$ mapeia para %WINDIR%, que pode ser C:\windows.
- $OEM$\$progs mapeia para o diretório de arquivos do programa.
- $OEM$\$docs mapeia para a pasta Meus Documentos do usuário.
/MigNEO
Informa à Instalação do Windows para executar uma atualização do Windows sem otimizações de fase offline adicionais.
Sintaxe
/MigNEO Disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim apenas com /Auto Upgrade | DataOnly |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim apenas com /Auto Upgrade | DataOnly |
Comentários
NEO significa Non-event Objective, um esforço de vários lançamentos para reduzir o tempo de atualização de recursos offline, incluindo uma única reinicialização para a maioria dos usuários. Esta opção está disponível a partir do Windows 10, versão 1803 e posterior.
/MigrateDrivers
Instrui a Instalação do Windows se os drivers da instalação existente devem ser migrados durante a atualização.
Sintaxe
/MigrateDrivers {All | None}
Exemplos
setup /auto upgrade /migratedrivers all
setup /auto upgrade /migratedrivers none /installdrivers N:\NewDrivers
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Você pode especificar Todos ou Nenhum. Por padrão, a Instalação do Windows decide qual é o melhor para cada driver individual com base na opção de instalação. Você pode usar essa opção com /InstallDrivers, embora não seja necessária.
/NetDebug
Habilita a depuração do kernel pela rede.
Sintaxe
/NetDebug:hostip=<w.x.y.z>,port=<n>,key=<q.r.s.t>[,nodhcp][,busparams=<n.o.p>]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <w.x.y.z> | Endereço IP do computador host. |
| <n> | Porta do computador host. |
| <q.r.s.t> | Senha para configurar uma conexão segura. |
| <n.o.p> | Número do barramento, número do dispositivo e número da função de um adaptador para um dispositivo de barramento PCI específico. |
Exemplos
setup /netdebug:hostip=10.125.4.86,port=50000,key=0.0.0.0
setup /netdebug:hostip=10.125.4.86,port=50000,key=abcdefg.123.hijklmnop.456,nodhcp
setup /netdebug:hostip=10.1.4.8,port=50000,key=dont.use.previous.keys,busparams=1.5.0
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Use hostip para identificar o endereço IP do computador host. Use port para identificar a porta. A porta inicial padrão é 49152 e a porta final padrão é 65535. Use key para fornecer uma senha para configurar uma conexão segura. Use nodhcp para evitar o uso de uma conexão DHCP. (opcional). Use busparams para selecionar o número do barramento, o número do dispositivo e o número da função de um adaptador para um dispositivo de barramento PCI específico. (opcional). Para obter detalhes adicionais, consulte Configurando a depuração no modo kernel em um cabo de rede manualmente.
/NoReboot
Instrui a Instalação do Windows a não reiniciar o computador após a conclusão da fase de nível inferior da Instalação do Windows.
Sintaxe
/NoReboot
Exemplos
setup /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Esta opção é nova para o Windows 10. A opção /NoReboot permite executar comandos adicionais antes da reinicialização do Windows. Essa opção suprime apenas a primeira reinicialização. A opção não suprime reinicializações subsequentes.
/PKey
Fornece à Instalação do Windows a chave do produto específica.
Sintaxe
/PKey <chave do produto>
Exemplos
setup.exe /auto upgrade /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção é nova a partir do Windows 10.
/Priority
Informa à Instalação do Windows para aumentar a prioridade de thread de baixa para normal para atualizações de recursos por meio do Windows Update.
Sintaxe
/Priority {Normal | Low}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Normal | A Instalação do Windows será executada com prioridade de thread normal. |
| Baixa | A Instalação do Windows será executada com baixa prioridade de thread. |
Exemplos
setup.exe /auto upgrade /skipfinalize /priority low
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10, versão 1709 e posterior. Prioridade baixa é nova para o Windows 10, versão 2004. As instalações baseadas em mídia já são executadas na prioridade Normal por padrão, mas podem ser reduzidas para a prioridade Baixa.
/PostOOBE
Após a conclusão da Instalação do Windows, execute um script.
Sintaxe
/PostOOBE<location> [\setupcomplete.cmd]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho do arquivo local ou caminho de rede UNC para um arquivo chamado setupcomplete.cmd ou para uma pasta que contém setupcomplete.cmd. |
Exemplos
setup.exe /auto upgrade /postoobe C:\Fabrikam\setupcomplete.cmd
Caminho para a pasta que contém um script com o nome setupcomplete.cmd. O setupcomplete.cmd é copiado para $Windows.~BT para ser executado após OOBE.
setup.exe /auto upgrade /postoobe C:\Fabrikam
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10.
/PostRollback
Instrui a Instalação do Windows a executar um script se a atualização de recurso falhar ao instalar e reverter as alterações, ou se o usuário optar por desinstalar a atualização de recurso e voltar para uma versão anterior do Windows.
Sintaxe
/PostRollback <location> [/PostRollbackContext {system | user}]
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho do arquivo local ou caminho de rede UNC para um arquivo chamado setuprollback.cmd ou para uma pasta que contém setuprollback.cmd. |
Exemplos
setup.exe /auto upgrade /postrollback C:\Fabrikam\setuprollback.cmd
setup.exe /postrollback C:\Fabrikam\setuprollback.cmd /postrollbackcontext user
setup.exe /auto upgrade /postrollback \server\share
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10. /PostRollbackContext opção está disponível no Windows 10, versão 1803 e posterior. A opção /PostRollbackContext permite especificar se o script é executado no contexto da conta do sistema ou da conta do usuário conectado. Por padrão, as atualizações da mídia executam o setuprollback.cmd no contexto do usuário que exige que o primeiro usuário que fizer logon após a atualização tenha direitos de administrador. Para atualizações do Windows Update, setuprollback.cmd é executado no contexto do sistema, independentemente dos direitos do primeiro usuário conectado. A Instalação do Windows copiará setuprollback.cmd para $Windows.~BT para ser executado após a OOBE.
/Quiet
Isso suprimirá qualquer experiência do usuário da Instalação do Windows, incluindo a experiência do usuário de reversão.
Sintaxe
/Quiet
Exemplos
setup /auto upgrade /quiet
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Esta opção está disponível a partir do Windows 10.
/ReflectDrivers
Especifica o caminho para uma pasta que contém drivers de criptografia para um computador que tenha criptografia de terceiros habilitada.
Sintaxe
/ReflectDrivers <location>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <local> | Caminho de arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .inf. |
Exemplos
setup /auto upgrade /quiet /reflectdrivers C:\Fabrikam\drivers
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10, versão 1607. Verifique se <localização> contém apenas um conjunto mínimo de drivers de criptografia. Ter mais drivers do que o necessário pode afetar negativamente os cenários de atualização.
/ResizeRecoveryPartition
Especifica se não há problema em redimensionar a partição existente do Ambiente de Recuperação do Windows (Windows RE) ou criar uma nova partição durante a instalação.
Sintaxe
/ResizeRecoveryPartition {Enable | Disable}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | Durante a instalação, o Windows pode redimensionar a partição de ferramentas existente do Windows RE ou criar uma nova, se necessário. |
| Desabilitar | O Windows não redimensiona a partição de ferramentas existente do Windows RE nem cria uma nova partição durante a instalação. |
Exemplos
setup /resizerecoverypartition disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Para saber mais sobre partições do Windows RE, consulte partições de disco rígido baseadas em UEFI/GPT e partições de disco rígido baseadas em BIOS/MBR.
/ShowOOBE
Especifica se o usuário é obrigado a concluir interativamente a experiência pronta para uso (OOBE).
Sintaxe
/ShowOOBE {Full | None}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Full | Requer que o usuário conclua interativamente a experiência pronta para uso (OOBE). |
| Nenhum | Ignora o OOBE e seleciona as configurações padrão. |
Exemplos
setup.exe /auto upgrade /showoobe full
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10.
/SkipFinalize
Configuração de instruções para iniciar operações de atualização no sistema operacional de nível inferior sem iniciar uma reinicialização para iniciar a fase offline.
Sintaxe
/SkipFinalize
Exemplos
setup /auto upgrade /quiet /priority low /skipfinalize
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Esta opção está disponível a partir do Windows 10, versão 2004. /SkipFinalize preparará a atualização sem confirmação. Isso permite que a confirmação seja concluída usando /Finalize seguido por uma reinicialização imediata do dispositivo. Essa é a abordagem preferida para a atualização pendente, pois a opção /NoReboot confirmará as alterações, mas suprimirá a primeira reinicialização para permitir tarefas adicionais. /SkipFinalize não instruirá automaticamente a Instalação do Windows a ser executada silenciosamente no sistema operacional de nível inferior enquanto o computador estiver em uso. Use /Quiet para suprimir a experiência do usuário da Instalação do Windows e /Prioridade Baixa para evitar o impacto do usuário. /SkipFinalize não invocará uma reinicialização e, portanto, a opção /NoReboot não é necessária. Veja /Finalize.
/Telemetry
Especifica se a Instalação do Windows deve capturar e relatar dados de instalação.
Sintaxe
/Telemetry {Enable | Disable}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | A Instalação do Windows captura e relata dados de instalação. |
| Desabilitar | A Instalação do Windows não captura nem relata dados de instalação. |
Exemplos
setup /telemetry disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
/TempDrive
Instrui a Instalação do Windows a colocar arquivos de instalação temporários na partição especificada.
Sintaxe
/TempDrive <drive_letter>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <drive_letter> | A partição para copiar arquivos de instalação durante a Instalação do Windows. |
Exemplos
setup /tempdrive H
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10, versão 1607. Para uma atualização, a opção /TempDrive afeta apenas o posicionamento de arquivos temporários. O sistema operacional é atualizado na partição a partir da qual você executa o arquivo setup.exe.
/Unattend
Permite que você use um arquivo de resposta com a Instalação do Windows.
Sintaxe
/Unattend:<answer_file>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <answer_file> | O caminho do arquivo e o nome do arquivo de resposta autônomo da Instalação do Windows. |
Exemplos
setup /unattend:\\server\share\unattend.xml
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Isso é conhecido como uma instalação autônoma. Você deve especificar um valor para <answer_file>. A Instalação do Windows aplica os valores no arquivo de resposta durante a instalação. Quando /Unattend é usado, /Auto não pode ser usado.
/Uninstall
Determina se o Windows incluirá controles que permitem que o usuário volte ao sistema operacional anterior.
Sintaxe
/Desinstalar {Ativar | Desativar}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Habilitar | A Instalação do Windows inclui controles que permitem que o usuário volte ao sistema operacional anterior. |
| Desabilitar | A Instalação do Windows não inclui controles que permitem que o usuário volte ao sistema operacional anterior. |
Exemplos
setup /uninstall disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Não |
| Setup.exe iniciada a partir do Windows 10 ou superior | Sim |
| Arquivos setupconfig.ini usados para atualizações de recursos | Sim |
Comentários
Esta opção está disponível a partir do Windows 10.
/USBDebug
Configura a depuração em uma porta USB.
Sintaxe
/USBDebug:<hostname>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <hostname> | O nome do computador a ser depurado. |
Exemplos
setup /usbdebug:testmachine01
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Os dados de depuração são efetivos na próxima reinicialização.
/WDSDiscover
Especifica que o cliente WDS (Serviços de Implantação do Windows) deve estar no modo de descoberta.
Sintaxe
/WDSDiscover
Exemplos
Para iniciar o cliente WDS no modo de descoberta dinâmica, execute o seguinte comando:
setup /wds /wdsdiscover
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Essa opção não está mais disponível a partir do Windows 11, versão 21H2. Se você não especificar /WDSServer o WDS procurará um servidor.
/WDSServer
Especifica o nome do servidor WDS (Serviços de Implantação do Windows) ao qual o cliente deve se conectar.
Sintaxe
/WDSServer:<servername>
Parâmetros
| Parâmetro | Descrição |
|---|---|
| <servername> | O nome do servidor dos Serviços de Implantação do Windows. |
Exemplos
Para iniciar o cliente dos Serviços de Implantação do Windows no modo de descoberta estático, execute o seguinte comando:
setup /wds /wdsdiscover /wdsserver:MyWDSServer
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe iniciada a partir do WinPE | Sim |
| Setup.exe iniciada a partir do Windows 10 ou superior | Não |
| Arquivos setupconfig.ini usados para atualizações de recursos | Não |
Comentários
Essa opção não está mais disponível a partir do Windows 11, versão 21H2. Para usar essa configuração, você também deve usar a opção /WDSDiscover. O <servername> pode ser um endereço IP, um nome NetBIOS ou um FQDN (nome de domínio totalmente qualificado).
Códigos de saída da Instalação do Windows
| Nome do código de saída | Valor do código de saída | Descrição |
|---|---|---|
| CONX_SETUP_EXITCODE_CONTINUE_REBOOT | 0x3 | Esta atualização foi bem-sucedida. |
| CONX_SETUP_EXITCODE_RESUME_AT_COMPAT_REPORT | 0x5 | A verificação de compatibilidade detectou problemas que exigem resolução antes que a atualização possa continuar. |
| CONX_SETUP_EXITCODE_AUTO_INSTALL_FAIL | 0x7 | A opção de instalação (atualização ou somente dados) não estava disponível. |
Tópicos relacionados
Estados de instalação do Windows
Configuração da Edição de Instalação do Windows e Arquivos de ID do Produto (EI.cfg e PID.txt)