Partilhar via


Opções da Linha de Comando para Instalação do Windows

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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe foi iniciado a partir do Windows 10 ou superiorNão
setupconfig.ini arquivos usados para atualizações de recursosNã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
LimpezaExecuta uma instalação limpa do Windows.
Apenas dadosExecuta 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.
AtualizarExecuta 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.
NoAutoEitNã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.
PerformDUNã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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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
SempreSuspenderO BitLocker é sempre suspenso durante uma atualização.
TryKeepActiveTenta 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.
ForceKeepActivePermite 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes

/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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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
EnableConfiguração do Windows instala o Windows usando ficheiros de sistema compactados.
DisableA 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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
IgnorarAvisoA Instalação do Windows conclui a instalação, ignorando quaisquer mensagens de compatibilidade dispensáveis.
ScanOnlyA 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosSim 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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
EnableO prompt de comando pode ser acessado pressionando Shift + F10 durante a instalação do Windows.
DisableO 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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
EnableAs operações de Atualização Dinâmica são executadas.
DisableAs operações de Atualização Dinâmica não são executadas.
NoDriversAs operações de Atualização Dinâmica são realizadas, com exceção da aquisição de drivers.
NoDriversNoLCUAs operações de Atualização Dinâmica são executadas, exceto para a aquisição do driver e da atualização cumulativa mais recente.
NoLCUAs 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosSim 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
COM1Habilita o EMS sobre COM1. Suportado apenas para sistemas x86.
COM2Permite EMS sobre COM2. Suportado apenas para sistemas x86.
UtilizarConfiguraçõesBIOSusa 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.
DesligadoDesativa 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosSim 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosSim 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPENã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 recursosSim 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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
NormalA Instalação do Windows será executada com prioridade de thread normal.
LowA 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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
EnableDurante a instalação, o Windows pode redimensionar a partição existente das ferramentas do Windows RE ou criar uma nova, se necessário.
DisableO 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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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
CompletoExige que o utilizador conclua interativamente a experiência de configuração inicial (OOBE).
NenhumIgnora 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosNã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
EnableInstalação do Windows captura e relata dados de instalação.
DisableA 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


/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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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
EnableA Instalação do Windows inclui controles que permitem que o usuário volte para o sistema operacional anterior.
DisableA 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 WinPENão
Setup.exe iniciado a partir do Windows 10 ou superior Yes
setupconfig.ini arquivos usados para atualizações de recursosYes


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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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 WinPEYes
Setup.exe iniciado a partir do Windows 10 ou superior Não
setupconfig.ini arquivos usados para atualizações de recursosNã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).

Estados de Instalação do Windows

Arquivos de Configuração e ID do Produto do Windows Setup Edition (EI.cfg e PID.txt)

Arquivos de log de instalação do Windows e logs de eventos

Códigos de saída da Instalação do Windows