Dela via


Exempel på testläge

Översikt

Exempel på testläge (STM) är en funktion som möjliggör snabbare bildåterställning av samplade enheter på fabriksgolvet. Funktionen använder en filterdrivrutin som är kopplad till Windows-partitionen och registrerar alla filsystemåtgärder på enheten samt säkerhetskopierar ändrade eller borttagna filer. Den här funktionen minskar tillverkningstiden och kostnaden för OEM-tillverkare och ODM:er vid testning av exempelenheter eftersom de inte behöver återskapa enheten. I stället loggar filterdrivrutinen alla aktiviteter och återställer enheten till standardtillståndet för användarleverans. I stora drag är processen för exempeltestning nedan:

  1. Tillverkaren tar en enhet (troligen i paketerat leveranstillstånd) från fabriksgolvet/lagret och startar datorn till WinRE (Recovery OS).
  2. Tillverkaren kör ett Microsoft-kommando på enheten med den installerade Windows-avbildningen för att aktivera funktionen/filterdrivrutinen. Teknikern startar sedan enheten för att simulera en slutanvändare och utför provkvalitetstester (t.ex. slutför OOBE, ansluta till internet, ladda ner/installera uppdateringar, installera funktioner, med mera).
  3. När testningen är klar startar tillverkaren datorn i WinRE och kör ett annat kommando för att återställa enheten till sitt ursprungliga tillstånd före OOBE. Processen för att återställa enheten går betydligt snabbare jämfört med ominstallering.
  4. Resultatet blir en Windows-avbildning som är identisk med villkoret före OOBE. Tillverkaren stänger sedan av enheten och gör den redo för leverans.

Exempel på testlägesversioner

Testläge för exempel stöds endast i Windows-klientversioner. Se nedan för Windows-versionen.

Windows-version Lansering
Windows 11 24H2

Kommandorader

Om du vill ange exempeltestningsläge startar du datorn utan att göra några ändringar och startar i WinRE. Följande DISM-kommandon används sedan för att aktivera och återställa ändringar.

Kommandorader Beskrivning Förutsättning
/Start-DUTMode Starta testläge efter start i WinRE
  1. Diskpartitionslayouten är standardlayouten som stöds.
  2. BitLocker är avstängd och disken är helt dekrypterad.
  3. Systemet återförs till OOBE utan användarprofiler.
/Revert-DUTMode Återställ ändringar som gjorts under testläget för att datorn ska återgå till ursprungligt tillstånd
  1. BitLocker är inaktiverat och disken är helt dekrypterad (före /Revert-DUTMode använder du "manage-bde" för att hämta BitLocker-statusen och dekryptera os-partitionen fullständigt.)
  2. Ingen partition har formaterats.
  3. Ingen oväntad eller tvingad omstart eller avstängning av enheten
  4. Enheten startade inte till en miljö som inte stöds , till exempel enheten som startades till WinPE som inte har STM-funktionen och drivrutinen aktiverad. Se "Support för diskpartitioner" nedan för mer information om stödda och icke-stödda miljöer.
  5. STM-drivrutinen "WinSetupBak" avlastades inte manuellt eller togs bort av användaren.
  6. Ingen funktionsuppdatering gjordes på enheten under exempeltestningen.
  7. Windows Recovery-partitionen (WinRE) ändrades inte i storlek med Windows Update. Inga ändringar ska göras i WinRE.

Användningsguide för exempeltestläge

Så här startar du exempeltestläget

  1. Starta till OOBE-skärmen
  2. Tryck på Ctrl-Skift-F5. Detta bör starta om datorn till återställningsoperativsystemet
  3. Välj "Felsöka" > "Avancerade alternativ" > "Kommandotolk", detta bör öppna ett cmd.exe fönster
  4. Kör DISM-kommandot för att aktivera DUT-läget: dism.exe/Start-DUTMode
DISM.exe /Start-DUTMode
  1. Datorn är nu redo att testa med filterdrivrutinen (WinSetupBak) ansluten och igång. Du kan köra fltmc.exe för att se drivrutinen (WinSetupBak) längst ned i stacken.
DISM.exe /fltmc.exe 

Så här återställer du ändringar som gjorts under testningen

Viktigt!

Innan du påbörjar återställningsproceduren måste du använda "manage-bde" för att hämta BitLocker-status och helt dekryptera OS-partitionen och inaktivera BitLocker.

  1. När du är redo att återställa enheterna till dess ursprungliga tillstånd går du till appen Inställningar
  2. På fliken "System" till höger rullar du ned till panelen "Återställning" och klickar på den.
  3. I panelen "Avancerad start" klickar du på knappen Starta om nu. Datorn bör nu starta om till återställningsoperativsystemet.
  4. Välj "Felsöka" > "Avancerade alternativ" > "Kommandotolk", detta bör öppna ett cmd.exe fönster
  5. Kör DISM-kommandot för att återställa DUT-läget: dism.exe/Revert-DUTMode
DISM.exe /Revert-DUTMode
  1. Du bör se ett förloppsfält och en bekräftelse på att kommandot har slutförts.

Felsökning av STM

Var du hittar STM-loggfiler

I det här avsnittet beskrivs var du hittar de nödvändiga loggfilerna baserat på resultatet av din åtgärd.

Lyckad återställning

Om återställningen lyckades kan alla relevanta loggfiler hittas i följande katalog:

  • X:\Windows\Logs\DISM

Felsökning av misslyckanden:

Samla in följande loggfiler för felsökning baserat på det specifika felscenariot:

  • Det gick inte att starta DUT-läget: Samla in loggar från:
    • X:\Windows\Logs\DISM
  • Det gick inte att återställa DUT-läget: Omedelbart efter återställningen misslyckas samlar du in loggar från:
    • X:\Windows\Logs\DISM
    • C:\$WINDOWS.~BK\WinSetupBak.log
    • C:\$WINDOWS.~BK\Operations.jrn

Avancerad felsökning (utförlig loggning):

Mer detaljerade loggar för att lösa komplexa problem:

  1. Ange miljövariabeln WINSETUPBAK_VERBOSE=1innan du återskapar problemet.
  2. Samla in loggfilerna enligt beskrivningen i avsnittet "Felsökningsfel" som är relevanta för ditt scenario.

Viktigt: Aktivering av utförlig loggning genererar mycket stora loggfiler (eventuellt över 1 GB) och kan försämra systemets prestanda. Använd endast det här alternativet när det behövs specifikt för djupgående undersökning.

Stöd för diskpartitioner

Diskpartitionens layout

Den första versionen av den här funktionen stöder endast följande diskpartitionslayout:

  1. Enskild disk
  2. Standard-UEFI-partitionslayout: Partitioner för EFI-system, MSR, Windows och Återställning

Ändringar i enheten

Den första versionen av den här funktionen stöder endast återställning av ändringar till följande partitioner:

  1. EFI-system
  2. Windows
  3. Återhämtning

Alla andra ändringar av enhetens tillstånd, inklusive följande stöds inte och kan inte återställas:

  1. Ändringar av diskar och partitioner utanför diskpartitionslayouten som stöds och partitioner som stöds.
  2. Nyligen skapade filer och ändringar av de nya filerna i WinRE- och EFI-systempartitionen stöds inte och ändringar som görs går inte att ångra. Ändringar som görs i befintliga filer kan dock ångras med /Revet-DUTMode.
  3. Partition har lagts till eller tagits bort efter /Start-DUTMode
  4. Ändringar i enhetens UEFI-tillstånd
  5. Ändringar i enhetens firmware-tillstånd

Vanliga frågor

Vilka begränsningar finns för den här funktionen?

Ändringar av enheten som INTE kommer att återställas av funktionen:

  1. Ändringar i innehållet i alla partitioner utanför Partitionerna MainOS, EFI och WINRE. För närvarande kan ändringar som görs i WinRE- och EFI-partitioner återställas, men inte när nya filer skapas, ändras och tas bort. Mer information finns i avsnittet "Kända problem".
  2. Ändringar i inbyggd programvara.
  3. Ändringar på tjänstsidan som görs under exempeltestningsproceduren med molntjänster.

Hur vet vi att enheten är i exempeltestningsläge?

En vattenstämpel som visas i operativsystemet har planerats för att indikera när en enhet är i STM. Om du vill identifiera en enhet i STM-läge kan du köra fltmc.exe för att se drivrutinen (WinSetupBak) längst ned i stacken.

Vilka är de kända problemen just nu?

  1. I vissa fall finns det en extra "$Windows.~BK"-mapp kvar på disken efter att bitLocker dekrypterats, startats till WinRE och kört kommandot DISM/Revert-DUTMode. Det här är ett känt rensningsproblem och vi planerar att åtgärda det i någon av de kommande versionerna.
  2. Nyligen skapade filer och ändringar av de nya filerna i WinRE- och EFI-systempartitionen stöds inte och ändringar som görs går inte att ångra. Ändringar som görs i befintliga filer kan dock ångras med /Revet-DUTMode. Vi arbetar med att åtgärda problemet vid nästa versioner.