Partilhar via

Modo de teste de amostra

Visão geral

O Modo de Teste de Amostra (STM) é um recurso que permite uma restauração de imagem mais rápida de dispositivos amostrados no chão de fábrica. O recurso utiliza um driver de filtro que é anexado à partição do Windows e registra todas as operações do sistema de arquivos no dispositivo, bem como faz backup de arquivos alterados ou excluídos. Esse recurso reduz o tempo e o custo de fabricação para OEMs e ODMs ao testar dispositivos de amostra, pois eles não precisam recriar a imagem do dispositivo. Em vez disso, o driver de filtro regista todas as atividades e reverte o dispositivo para o estado padrão para envio para o utilizador. Em um nível alto, abaixo está o processo do Modo de teste de amostra:

  1. O fabricante pega um dispositivo (provavelmente em um estado de envio empacotado) do chão de fábrica/armazém e inicializa a máquina no WinRE (Recovery OS).
  2. O fabricante executa um comando fornecido pela Microsoft no dispositivo com a imagem do Windows instalada para ativar o driver de recurso/filtro. Em seguida, o técnico inicializa o dispositivo para simular um usuário final e executa testes de qualidade de amostra (por exemplo, OOBE completo, conectar-se à internet, baixar/instalar atualizações, instalar recursos, etc.).
  3. Quando o teste estiver concluído, o fabricante inicializa a máquina no WinRE e executa outro comando para reverter o dispositivo ao seu estado original anterior à OOBE. A operação para reverter o dispositivo é significativamente mais rápida em comparação com uma nova imagem.
  4. O resultado seria uma imagem do Windows idêntica à condição anterior à OOBE. Em seguida, o fabricante desliga o dispositivo e prepara-o para envio.

Exemplos de versões do modo de teste

O Modo de Teste de Exemplo só é suportado em Client Windows Editions. Veja abaixo a versão para Windows.

Versão do Windows Lançamento
Janelas 11 24H2

Linhas de comando

Para entrar no Modo de Teste de Amostra, inicie sua máquina sem alterações feitas e inicialize no WinRE. Os seguintes comandos do DISM são usados para habilitar e reverter alterações.

Linhas de comando Descrição Pré-requisito
/Start-DUTMode Iniciar o modo de teste após a inicialização no WinRE
  1. O layout de partição de disco é o layout padrão suportado.
  2. O BitLocker está desligado e o disco está totalmente desencriptado.
  3. O sistema é selado novamente para OOBE sem perfis de usuário.
/Revert-DUTMode Reverter as alterações feitas durante o modo de teste para que a máquina retorne ao estado original
  1. O BitLocker é desativado e o disco é totalmente descriptografado (Antes de /Revert-DUTMode, use "manage-bde" para obter o status do BitLocker e descriptografar totalmente a partição do sistema operacional.)
  2. Nenhuma partição foi formatada.
  3. Nenhuma reinicialização ou desligamento inesperado ou forçado do dispositivo
  4. O dispositivo não inicializou em um ambiente não suportado – por exemplo, o dispositivo inicializou no WinPE, que não tem o recurso STM e o driver habilitado. Consulte "Suporte em partição de disco" abaixo para obter mais informações sobre o ambiente suportado e não suportado.
  5. STM driver "WinSetupBak" não foi manualmente descarregado ou removido pelo usuário.
  6. Nenhuma atualização de recurso foi feita no dispositivo durante o teste de amostra.
  7. A partição de recuperação do Windows (WinRE) não foi redimensionada pelo Windows Update. Nenhuma alteração deve ser feita no WinRE.

Guia de uso para o modo de teste de amostra

Para iniciar o Modo de Teste de Amostra

  1. Iniciar no ecrã de configuração inicial (OOBE)
  2. Pressione Ctrl-Shift-F5, isso deve reiniciar a máquina para o sistema operacional de recuperação
  3. Escolha "Resolução de problemas" > "Opções avançadas" > "Prompt de comando", o que deverá abrir uma janela cmd.exe
  4. Execute o comando DISM para ativar o modo DUT: dism.exe /Start-DUTMode
DISM.exe /Start-DUTMode
  1. A máquina agora está pronta para testar com o driver de filtro (WinSetupBak) conectado e em execução. Você pode executar fltmc.exe para ver o driver (WinSetupBak) na parte inferior da pilha.
DISM.exe /fltmc.exe 

Para reverter as alterações feitas durante o teste

Importante

Antes de iniciar o procedimento de restauração, certifique-se de que utiliza "manage-bde" para obter o estado do BitLocker, desencriptar totalmente a partição do SO e desativar o BitLocker.

  1. Quando estiver pronto para restaurar os dispositivos ao seu estado original, aceda à aplicação "Definições"
  2. Na guia "Sistema", no lado direito, role para baixo até o bloco "Recuperação", clique nele.
  3. No bloco "Inicialização avançada", clique no botão "Reiniciar agora". A máquina deve agora reiniciar para o sistema operativo de recuperação.
  4. Escolha "Resolução de problemas" > "Opções avançadas" > "Prompt de comando", o que deverá abrir uma janela cmd.exe
  5. Execute o comando DISM para reverter o modo DUT: dism.exe /Revert-DUTMode
DISM.exe /Revert-DUTMode
  1. Você verá uma barra de progresso e a confirmação de que o comando foi concluído com êxito.

Solução de problemas do STM

Onde encontrar arquivos de log do STM

Esta seção explica onde encontrar os arquivos de log necessários com base no resultado da sua operação.

Reversão bem-sucedida

Se a operação de reversão foi bem-sucedida, todos os arquivos de log relevantes podem ser encontrados no seguinte diretório:

  • X:\Windows\Logs\DISM

Solução de problemas de falhas:

Colete os seguintes arquivos de log para fins de solução de problemas com base no cenário de falha específico:

  • Falha ao iniciar o modo DUT: Recolha os registos de:
    • X:\Windows\Logs\DISM
  • Falha ao reverter o modo DUT: Imediatamente após a reversão falhar, colete logs de:
    • X:\Windows\Logs\DISM
    • C:\$WINDOWS.~BK\WinSetupBak.log
    • C:\$WINDOWS.~BK\Operations.jrn

Solução de problemas avançada (log detalhado):

Para obter logs mais detalhados para ajudar a resolver problemas complexos:

  1. Defina a variável WINSETUPBAK_VERBOSE=1 de ambiente antes de reproduzir o problema.
  2. Colete os arquivos de log conforme descrito na seção "Solução de problemas de falhas" relevante para o seu cenário.

Nota importante: Habilitar o registro detalhado gerará arquivos de log muito grandes (potencialmente acima de 1GB) e poderá diminuir o desempenho do sistema. Utilize esta opção apenas quando for especificamente necessário para uma investigação aprofundada.

Suporte em partições de disco

Layout de partição de disco

A versão inicial deste recurso suporta apenas o seguinte layout de partição de disco:

  1. Disco único
  2. Layout de partição UEFI padrão: partições EFI System, MSR, Windows e Recovery

Alterações ao dispositivo

A versão inicial deste recurso suporta apenas a reversão de alterações para as seguintes partições:

  1. Sistema de EFI
  2. Mac OS
  3. Recuperação

Todas as outras alterações ao estado do dispositivo, incluindo as seguintes, não são suportadas e não poderão ser revertidas:

  1. Alterações em discos e partições fora do layout de partição de disco suportado e partições suportadas.
  2. Arquivos recém-criados e modificações para os novos arquivos na partição do sistema WinRE e EFI não serão suportados e as alterações feitas são irreversíveis. No entanto, as alterações feitas nos arquivos existentes podem ser revertidas com /Revet-DUTMode.
  3. Partição adicionada ou removida após /Start-DUTMode
  4. Alterações no estado UEFI do dispositivo
  5. Alterações ao estado do firmware do dispositivo

Perguntas Frequentes

Quais são as limitações desta funcionalidade?

Alterações no dispositivo que NÃO serão restauradas pelo recurso:

  1. Alterações no conteúdo de quaisquer partições fora das partições MainOS, EFI e WINRE. Atualmente, as alterações feitas nas partições WinRE e EFI podem ser restauradas, mas não quando novos arquivos são criados, modificados e excluídos. Consulte a secção "Problemas conhecidos" para obter mais detalhes.
  2. Alterações no firmware.
  3. Alterações do lado do serviço feitas durante o procedimento de teste de amostra com serviços de nuvem.

Como sabemos que o dispositivo está no Modo de Teste de Amostra?

Uma marca d'água exibida no sistema operacional foi planejada para indicar quando um dispositivo está no STM. Para identificar um dispositivo no modo STM, você pode executar fltmc.exe para ver o driver (WinSetupBak) na parte inferior da pilha.

Quais são os problemas conhecidos a partir de agora?

  1. Em alguns casos, depois de garantir que o BitLocker seja descriptografado, inicializar no WinRE e executar o comando DISM /Revert-DUTMode, há uma pasta extra "$Windows.~BK" ainda presente no disco. Este é um problema de limpeza conhecido e planejamos corrigi-lo em uma das próximas versões.
  2. Arquivos recém-criados e modificações para os novos arquivos na partição do sistema WinRE e EFI não serão suportados e as alterações feitas são irreversíveis. No entanto, as alterações feitas nos arquivos existentes podem ser revertidas com /Revet-DUTMode. Estamos a trabalhar para corrigir o problema nas próximas versões.