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.
As seguintes opções de linha de comando 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 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
Permite a depuração do kernel através de uma porta IEEE 1394 (FireWire) enquanto o Windows está em execução e durante o passo de configuração do WindowsPE da Instalação do Windows.
Syntax
/1394Debug:<canal> [BaudRate:<baudrate>]
Examples
setup /1394debug:1 /baudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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 Gestor de Arranque do Windows como a última entrada na ordem de arranque do firmware UEFI.
Syntax
/AddBootMgrLast
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe foi iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Essa opção só é suportada em computadores UEFI que executam o Windows PE 4.0 ou posterior.
/Automático
Executa uma atualização automatizada para uma versão mais recente do Windows.
Syntax
/Auto {Limpar | DataOnly | Atualização}
Parâmetros
| Parâmetro | Description |
|---|---|
| Limpeza | Executa uma instalação limpa do Windows. |
| Apenas dados | 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 sairá silenciosamente e registrará um código de saída. |
| Atualizar | Executa uma atualização do Windows que mantém os aplicativos e dados. Se a opção de instalação de atualização não estiver disponível ou se o usuário precisar resolver um problema de compatibilidade de aplicativo, a Instalação do Windows sairá 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 padrão da Interface de Utilizador do Sistema que o dispositivo de destino. Em versões anteriores do Windows, você poderia 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 for encontrado um erro, a Configuração do Windows não termina, mas pausa e permanece no ecrã da Configuração do Windows até que o utilizador resolva o problema. A instalação a partir desse ponto é monitorada. |
| 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 |
Examples
setup /auto clean
setup /auto dataonly
setup /auto upgrade
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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. Quando /Auto é usado, somente as seguintes personalizações 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 um esclarecimento:
- Aplicação de uma atualização cumulativa (de qualidade)
- Aplicação de atualizações à pilha de serviços necessária para concluir a atualização de recursos (consulte Atualizações da pilha de serviços para obter mais informações)
- Aplicando atualizações a binários de Setup.exe ou outros ficheiros que a Instalação usa para atualizações de funcionalidades
- Aplicando atualizações para o "sistema operacional seguro" (SafeOS) que é usado para o ambiente de recuperação do Windows
- Adicionar ou remover idiomas
- Adicionando ou removendo 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 em uma imagem do Windows que tenha sido personalizada adicionando/removendo/alterando aplicativos, configurações ou drivers.
Quando /Auto é usado, a Instalação do Windows será atualizada usando a imagem \sources\install.wim do Windows. Usando o 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, /Auto não aceitará nem substituirá o contrato de licença de usuário final. Ver /EULA.
/BitLocker
Especifica o status do BitLocker durante as atualizações.
Syntax
/BitLocker {AlwaysSuspend | TryKeepActive | ForceKeepActive}
Parâmetros
| Parâmetro | Description |
|---|---|
| SempreSuspender | 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. Este é o comportamento padrão se a opção /BitLocker não for especificada. |
| ForceKeepActive | Permite 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 começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
/BusParams
Especifica o endereço PCI de uma porta de depuração 1394, USB ou NET.
Syntax
/BusParams:<bus.device.function>
Examples
setup /busparams:0.29.7
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Os números de barramento, dispositivo e função devem estar em formato decimal. Para obter mais informações, consulte Configuração de depuração do kernel com USB 2.0.
/ConfigFile
Especifica a localização do ficheiro setupconfig.
Syntax
/ConfigFile:<localização>
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho de ficheiro local ou caminho de rede UNC para uma pasta que contém o ficheiro de configuração do Windows Setup. |
Examples
setup /ConfigFile:\\server\share\
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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. Suporte do WinPE a partir do Windows 11, versão 24H2.
/CompactOS
Especifica se o recurso Compact OS deve ser usado para economizar espaço no disco rígido.
Syntax
/CompactOS {Ativar | Desativar}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | Configuração do Windows instala o Windows usando ficheiros de sistema compactados. |
| Disable | A Configuração do Windows instala o Windows usando ficheiros de sistema não compactados. |
Examples
setup /compactos enable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Por padrão, a Instalação do Windows determina se esse recurso deve ser usado automaticamente. Para saber mais sobre o Compact OS, consulte Compact OS, instanciação única e otimização de imagem. Suporte do WinPE a partir do Windows 11, versão 24H2.
/Compat
Instrui a Instalação do Windows sobre como lidar com verificações e mensagens de compatibilidade.
Syntax
/Compat {IgnoreWarning | ScanOnly}
Parâmetros
| Parâmetro | Description |
|---|---|
| IgnorarAviso | A Instalação do Windows conclui a instalação, ignorando quaisquer mensagens de compatibilidade dispensáveis. |
| ScanOnly | A Instalação do Windows executa verificações de compatibilidade e depois termina (sem concluir a instalação) com um código de saída para indicar se há qualquer problema de compatibilidade. A Instalação do Windows retornará 0xC1900210 se nenhuma preocupação for encontrada. A Instalação do Windows retornará 0xC1900208 se forem encontrados problemas de compatibilidade. |
Examples
setup /compat ignorewarning
Este comando funciona com outras opções. Para executar a Instalação do Windows em segundo plano sem nenhuma interface do usuário:
setup /auto upgrade /quiet /compat scanonly
Para desconsiderar avisos comuns na interface de utilizador, por exemplo, alterações de idioma:
setup /auto upgrade /quiet /compat scanonly /compat ignorewarning
Muitas vezes, um profissional de TI examinará o compat XML 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 começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Sim apenas com /Compat IgnoreWarning |
Remarks
Esta opção está disponível a partir do Windows 10 e superior.
Se iniciar o programa de configuração do Windows com /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 aplicações, ele retornará MOSETUP_E_COMPAT_INSTALLREQ_BLOCK (0xC1900208)
- Se verificar que o Mig-Choice selecionado não está disponível, o sistema retornará MOSETUP_E_COMPAT_MIGCHOICE_BLOCK (0xC1900204)
- Se ele descobrir que a máquina não é qualificada para o Windows 10 ou superior, ele retornará MOSETUP_E_COMPAT_SYSREQ_BLOCK (0xC1900200)
- Se ele 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 à rede no local.
Syntax
/CopyLogs <localização>
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminhos de rede UNC. |
Examples
setup /copylogs \\server\share\
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Os parâmetros aceitos são caminhos de arquivo locais e caminhos de rede UNC. A execução é executada no contexto do sistema, portanto, pode não ter permissões para copiar para locais que exigem permissões de usuário. Suporte do WinPE a partir do Windows 11, versão 24H2.
/Depurar
Permite a depuração do kernel numa porta de comunicações (COM) quando o Windows está em execução e durante a fase de configuração do WindowsPE da Instalação do Windows.
Syntax
/Debug:<port> [BaudRate:<baudrate>]
Parâmetros
| Parâmetro | Description |
|---|---|
| <porto> | Especifica a porta de depuração. O valor padrão é 1. |
| <baudrate> | Especifica o baud a ser utilizado 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. |
Examples
setup /debug:1 /baudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
/DiagnosticPrompt
Especifica que o Prompt de Comando está disponível durante a Instalação do Windows.
Syntax
/DiagnosticPrompt {Ativar | Desativar}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | O prompt de comando pode ser acessado pressionando Shift + F10 durante a instalação do Windows. |
| Disable | O prompt de comando não está disponível durante a instalação do Windows. A Linha de Comandos não estará disponível enquanto as fases offline e OOBE estiverem em execução. Esta é a configuração padrão. |
Examples
setup /diagnosticprompt enable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10, versão 1703. Suporte do WinPE a partir do Windows 11, versão 24H2.
/Atualização Dinâmica
Especifica se a Instalação do Windows executará operações de Atualização Dinâmica (pesquisar, baixar e instalar atualizações).
Syntax
/DynamicUpdate {Ativar | Desativar | NoDrivers | NoLCU | NoDriversNoLCU}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | As operações de Atualização Dinâmica são executadas. |
| Disable | As operações de Atualização Dinâmica não são executadas. |
| NoDrivers | As operações de Atualização Dinâmica são realizadas, com exceção da aquisição de drivers. |
| NoDriversNoLCU | As operações de Atualização Dinâmica são executadas, exceto para a aquisição do driver e da atualização cumulativa mais recente. |
| NoLCU | As operações de Atualização Dinâmica são executadas, exceto a aquisição de atualizações cumulativas mais recente. |
Examples
setup /auto upgrade /dynamicupdate disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos 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 |
Remarks
NoDrivers, NoLCU e NoDriversNoLCU são novos para o Windows 10, versão 2004. Quando NoDrivers, NoLCU ou NoDriversNoLCU são especificados , 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 executados.
/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.
Syntax
/EMSPort: {COM1 | COM2 | UseBIOSSettings | Off} [/EMSBaudRate:<baudrate>]
Parâmetros
| Parâmetro | Description |
|---|---|
| COM1 | Habilita o EMS sobre COM1. Suportado apenas para sistemas x86. |
| COM2 | Permite EMS sobre COM2. Suportado apenas para sistemas x86. |
| UtilizarConfiguraçõesBIOS | 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 do console EFI for especificado no BIOS, o Windows desativará o EMS. |
| Desligado | Desativa o EMS. Se o EMS estiver desativado na Instalação do Windows, você poderá habilitar o EMS modificando as configurações de inicialização. |
| <Baudrate> | Especifica o baud a ser utilizado quando o Windows transfere dados durante a depuração. O valor padrão é 19200, mas também pode ser definido como 57600 ou 115200. |
Examples
setup /emsport:COM1 /emsbaudrate:115200
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
/EULA
Instruções da 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.
Syntax
/EULA aceitar
Examples
setup /auto upgrade /quiet /eula accept
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção é nova a partir do Windows 11. Especificar /EULA accept instrui a Configuração do Windows que o contrato de licença de usuário final foi aceite. A partir do Windows 11, a aceitação do EULA do Windows é necessária antes do início da instalação do Windows. Ao especificar /EULA accept , você concorda que, ao aplicar este sistema operacional, (1) a licença do Windows aplicável 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 for suportada. Para saber mais sobre licenciamento, consulte Termos de Licença da Microsoft.
/Finalizar
Instruções ao Windows Setup para concluir as operações de atualização iniciadas anteriormente no down-level OS, seguidas de uma reinicialização imediata para iniciar a fase offline.
Syntax
/Finalizar
Examples
setup /auto upgrade /finalize
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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 ser retomado após a execução de /SkipFinalize. Consulte /SkipFinalize.
/ImageIndex
Instruções para a Instalação do Windows sobre qual imagem do sistema operacional deve ser instalada através do install.wim caso várias imagens sejam aplicáveis.
Syntax
/ImageIndex<>
Examples
setup.exe /auto upgrade /quiet /compat ignorewarning /imageindex 2 /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos 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 UUP (Unified Updated Platform) |
Remarks
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 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 no estilo .inf à nova instalação do Windows 10.
Syntax
Localização< de /InstallDrivers>
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .inf. |
Examples
setup.exe /auto upgrade /installdrivers C:\Fabrikam\drivers /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção é nova a partir do Windows 10. O driver .inf pode estar em uma pasta dentro do local especificado. O comando será repetido através do local especificado. Suporte do WinPE a partir do Windows 11, versão 24H2.
/Instalar De
Especifica um arquivo Install.wim diferente para usar durante a Instalação do Windows.
Syntax
/InstallFrom<caminho>
Parâmetros
| Parâmetro | Description |
|---|---|
| <caminho> | O caminho do arquivo .wim a ser instalado. |
Examples
setup /installfrom D:\custom.wim
Esta opção também pode ser usada com arquivos de imagem divididos (.swm). Selecione o primeiro arquivo de imagem dividido da série
setup /installfrom D:\install.swm
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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 obter mais informações, consulte "Criando um WIM para vários tipos de arquitetura" em Plataformas suportadas pela Instalação do Windows e implantações entre plataformas.
/InstallLangPacks
Adiciona pacotes de idiomas (lp.cab) à nova instalação do Windows 10 ou superior.
Syntax
/InstallLangPacks <localização>
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .cab. |
Examples
setup /auto upgrade /installlangpacks C:\Fabrikam\Languages\French /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos 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 UUP (Unified Updated Platform) |
Remarks
Esta opção é nova a partir do Windows 10. Os pacotes de idiomas podem estar numa pasta no 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 linguísticos podem ter dependido de outros recursos linguísticos. Por exemplo, Text-to-speech depende do componente Basic da mesma linguagem. As capacidades de linguagem não devem ser renomeadas dentro do< local>. Consulte Recursos de idioma e região sob demanda (FOD). No Windows 10, versão 1903 e posterior, falhas de instalação farão com que a Instalação do Windows falhe e seja revertida.
/m
Instrui a Instalação do Windows a copiar arquivos alternativos de um local alternativo. Esta 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.
Syntax
/m:<folder_name>
Parâmetros
| Parâmetro | Description |
|---|---|
| <folder_name> | Nome e o local da pasta que contém os ficheiros de substituição, e pode ser qualquer local da unidade local. Não há suporte para caminhos UNC. |
Examples
Para copiar o ficheiro atualizado C:\Program Files\Messenger\Msmsgs.exe para a instalação do Windows, crie a seguinte estrutura de pastas na fonte de instalação Pro\Sources\$OEM$\$Progs\Messenger\Msmsgs.exe usando o comando Setup:
Pro\sources\setup.exe /m
Se você substituir um arquivo que a proteção de arquivo 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, deverá adicionar os arquivos MUI (Multilanguage User Interface) atualizados à instalação.
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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$ em suas 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 de programas.
- $OEM$\$docs mapeia para a pasta Documentos do utilizador.
/MigNEO
Informa a Instalação do Windows para executar uma atualização do Windows sem otimizações adicionais de fase offline.
Syntax
/MigNEO Desativar
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Sim apenas com /Auto Upgrade | Apenas dados |
| setupconfig.ini arquivos usados para atualizações de recursos | Sim apenas com /Auto Upgrade | Apenas dados |
Remarks
Esta opção está disponível a partir do Windows 10, versão 1803 e posterior. NEO significa Objetivo sem Evento, um esforço de múltiplas versões para reduzir o tempo offline durante a atualização de funcionalidades, que inclui uma única reinicialização na maioria dos utilizadores. NEO muda muitas tarefas de instalação e migração de dados da fase offline de uma atualização de recursos (ou seja, quando seu PC é reinicializado e indisponível) para a fase online (ou seja, enquanto o sistema operacional ainda está em execução e disponível para uso).
/MigNEO dá aos administradores de TI a opção de desativar essas otimizações quando necessário. Ao implantar o Windows em uma configuração que restringe o acesso do usuário ao dispositivo durante todas as fases da Instalação do Windows, inclusive online, verifique se o NEO está desabilitado.
/MigrateDrivers
Instrui a Configuração do Windows sobre se deve migrar os drivers da instalação existente durante a atualização.
Syntax
/MigrateDrivers {Todos | Nenhum}
Examples
setup /auto upgrade /migratedrivers all
setup /auto upgrade /migratedrivers none /installdrivers N:\NewDrivers
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Você pode especificar Tudo 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ário.
/NetDebug
Permite a depuração do kernel pela rede.
Syntax
/NetDebug:hostip=<w.x.y.z>,port=<n>,key=<q.r.s.t>[,nodhcp][,busparams=<n.o.p>]
Parâmetros
| Parâmetro | Description |
|---|---|
| <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. |
Examples
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 começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Use hostip para identificar o endereço IP do computador host. Use a porta para identificação. A porta de início padrão é 49152 e a porta de extremidade padrão é 65535. Use a chave para fornecer uma senha para configurar uma conexão segura. Use nodhcp para evitar o uso de uma conexão DHCP. (opcional). Utilize busparams para escolher o número do barramento, o número do dispositivo e o número da função de um adaptador para um dispositivo específico de barramento PCI. (opcional). Para obter detalhes adicionais, consulte Configurar a depuração em modo Kernel através de 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.
Syntax
/NoReboot
Examples
setup /noreboot
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Esta opção é nova para o Windows 10. A opção /NoReboot permite executar comandos adicionais antes que o Windows seja reiniciado. Esta opção suprime apenas a primeira reinicialização. A opção não suprime reinicializações subsequentes. Suporte do WinPE a partir do Windows 11, versão 24H2.
/PKey
Fornece à Instalação do Windows a chave do produto (Product Key) específica.
Syntax
/PKey <chave> do produto
Examples
setup.exe /auto upgrade /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção é nova a partir do Windows 10. Suporte do WinPE a partir do Windows 11, versão 24H2.
/Prioridade
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.
Syntax
/Priority {Normal | Baixa}
Parâmetros
| Parâmetro | Description |
|---|---|
| Normal | A Instalação do Windows será executada com prioridade de thread normal. |
| Low | A Instalação do Windows será executada com baixa prioridade de thread. |
Examples
setup.exe /auto upgrade /skipfinalize /priority low
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10, versão 1709 e posterior.
A baixa prioridade é uma novidade para o Windows 10, versão 2004. As instalações baseadas em mídia já são executadas com prioridade Normal por padrão, mas podem ser reduzidas para Baixa prioridade.
/PostOOBE
Após a conclusão da Instalação do Windows, execute um script.
Syntax
/LocalizaçãoPostOOBE<> [\setupcomplete.cmd]
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminho de rede UNC para um arquivo chamado setupcomplete.cmd ou para uma pasta que contém setupcomplete.cmd. |
Examples
setup.exe /auto upgrade /postoobe C:\Fabrikam\setupcomplete.cmd
Caminho para a pasta que contém um script com o nome setupcomplete.cmd. 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 começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10. Suporte do WinPE a partir do Windows 11, versão 24H2.
/PostRollback
Instrui a Instalação do Windows a executar um script se a atualização de funcionalidade falhar ao instalar e anular as alterações, ou se o utilizador optar por desinstalar a atualização de funcionalidade e voltar para uma versão anterior do Windows.
Syntax
/PostRollback <location> [/PostRollbackContext {system | user}]
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminho de rede UNC para um arquivo chamado setuprollback.cmd ou para uma pasta que contém setuprollback.cmd. |
Examples
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 começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10.
A opção /PostRollbackContext 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 de mídia executam o setuprollback.cmd no contexto do utilizador, o que exige que o primeiro utilizador que faz login após a atualização tenha permissões 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 executada após a OOBE.
/Silencioso
Isto irá suprimir qualquer interação com o utilizador durante a Instalação do Windows, incluindo a reversão dessa interação.
Syntax
/Silencioso
Examples
setup /auto upgrade /quiet
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
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 a criptografia de terceiros habilitada.
Syntax
/ReflectDrivers <localização>
Parâmetros
| Parâmetro | Description |
|---|---|
| <Localização> | Caminho do arquivo local ou caminho de rede UNC para uma pasta que contém arquivos .inf. |
Examples
setup /auto upgrade /quiet /reflectdrivers C:\Fabrikam\drivers
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10, versão 1607. Certifique-se de que <o local> contém apenas um conjunto mínimo de controladores de criptografia. Ter mais drivers do que o necessário pode afetar negativamente os cenários de atualização. Suporte do WinPE a partir do Windows 11, versão 24H2.
/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 durante a instalação.
Syntax
/ResizeRecoveryPartition {Ativar | Desativar}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | Durante a instalação, o Windows pode redimensionar a partição existente das ferramentas do Windows RE ou criar uma nova, se necessário. |
| Disable | O Windows não redimensiona a partição existente das ferramentas do Windows RE nem cria uma nova durante a instalação. |
Examples
setup /resizerecoverypartition disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
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 utilizador deve concluir interativamente a experiência fora da caixa (OOBE).
Syntax
/ShowOOBE {Completo | Nenhum}
Parâmetros
| Parâmetro | Description |
|---|---|
| Completo | Exige que o utilizador conclua interativamente a experiência de configuração inicial (OOBE). |
| Nenhum | Ignora OOBE e seleciona as configurações padrão. |
Examples
setup.exe /auto upgrade /showoobe full
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
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 SO de nível inferior sem iniciar uma reinicialização para iniciar a fase offline.
Syntax
/SkipFinalize
Examples
setup /auto upgrade /quiet /priority low /skipfinalize
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Esta opção está disponível a partir do Windows 10, versão 2004.
/SkipFinalize preparará a atualização sem compromisso. Isso permite que a confirmação seja concluída usando /Finalize seguido por uma reinicialização imediata do dispositivo. Esta é a abordagem preferida para aguardar a atualização, uma vez que a opção /NoReboot irá aplicar as alterações, mas suprimir o primeiro reinício 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 /Priority Low para evitar impacto no usuário.
/SkipFinalize não invocará uma reinicialização e, portanto, a opção /NoReboot não é necessária. Consulte /Finalizar.
/Telemetria
Especifica se a Instalação do Windows deve capturar e relatar dados de instalação.
Syntax
/Telemetria {Ativar | Desativar}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | Instalação do Windows captura e relata dados de instalação. |
| Disable | A Configuração do Windows não captura nem reporta dados de instalação. |
Examples
setup /telemetry disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
/TempDrive
Instrui a Instalação do Windows a colocar arquivos de instalação temporários na partição especificada.
Syntax
/TempDrive <drive_letter>
Parâmetros
| Parâmetro | Description |
|---|---|
| <drive_letter> | A partição para a qual copiar arquivos de instalação durante a Instalação do Windows. |
Examples
setup /tempdrive H
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
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.
/Automático
Permite-lhe usar um ficheiro de resposta com a Instalação do Windows.
Syntax
/Unattend:<answer_file>
Parâmetros
| Parâmetro | Description |
|---|---|
| <ficheiro_resposta> | O caminho do arquivo e o nome do arquivo de resposta da Instalação autônoma do Windows. |
Examples
setup /unattend:\\server\share\unattend.xml
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Isso é conhecido como uma instalação autônoma. Você deve especificar um valor para <answer_file>. O programa de configuração do Windows aplica os valores no ficheiro de respostas durante a instalação. Quando /Unattend é usado, /Auto não pode ser usado.
/Desinstalar
Determina se o Windows incluirá controles que permitam ao usuário voltar ao sistema operacional anterior.
Syntax
/Desinstalar {Ativar | Desativar}
Parâmetros
| Parâmetro | Description |
|---|---|
| Enable | A Instalação do Windows inclui controles que permitem que o usuário volte para o sistema operacional anterior. |
| Disable | A Instalação do Windows não inclui controles que permitem que o usuário volte para o sistema operacional anterior. |
Examples
setup /uninstall disable
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Não |
| Setup.exe iniciado a partir do Windows 10 ou superior | Yes |
| setupconfig.ini arquivos usados para atualizações de recursos | Yes |
Remarks
Esta opção está disponível a partir do Windows 10.
/USBDebug
Configura a depuração numa porta USB.
Syntax
/USBDebug:<hostname>
Parâmetros
| Parâmetro | Description |
|---|---|
| <nome do host> | O nome do computador a ser analisado. |
Examples
setup /usbdebug:testmachine01
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Os dados de depuração entram em vigor na próxima reinicialização.
/WDSDiscover
Especifica que o cliente WDS (Serviços de Implantação do Windows) deve estar no modo de descoberta.
Syntax
/WDSDiscover
Examples
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 começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Esta 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.
Syntax
/WDSServer:<nomedoservidor>
Parâmetros
| Parâmetro | Description |
|---|---|
| <nome do servidor> | O nome do servidor dos Serviços de Implantação do Windows. |
Examples
Para iniciar o cliente dos Serviços de Implantação do Windows no modo de descoberta estática, execute o seguinte comando:
setup /wds /wdsdiscover /wdsserver:MyWDSServer
Aplicabilidade
| Configuração | Aplicável |
|---|---|
| Setup.exe começou a partir do WinPE | Yes |
| Setup.exe iniciado a partir do Windows 10 ou superior | Não |
| setupconfig.ini arquivos usados para atualizações de recursos | Não |
Remarks
Esta 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 .
<servername> pode ser um endereço IP, um nome NetBIOS ou um nome de domínio totalmente qualificado (FQDN).
Tópicos relacionados
Estados de Instalação do Windows
Arquivos de Configuração e ID do Produto do Windows Setup Edition (EI.cfg e PID.txt)