Freigeben über


Beispieltestmodus

Überblick

Der Beispieltestmodus (Sample Test Mode, STM) ist eine Funktion, die eine schnellere Imagewiederherstellung von getesteten Geräten in der Fertigung ermöglicht. Das Feature verwendet einen Filtertreiber, der an die Windows-Partition angefügt ist, und zeichnet alle Dateisystemvorgänge auf dem Gerät auf und sichert geänderte oder gelöschte Dateien. Dieses Feature reduziert die Fertigungszeit und die Kosten für OEMs und ODMs beim Testen von Beispielgeräten, da sie das Gerät nicht neu abbilden müssen. Stattdessen protokolliert der Filtertreiber alle Aktivitäten und stellt das Gerät wieder in den Standardzustand für die Benutzerlieferung zurück. Im Folgenden finden Sie eine allgemeine Übersicht über den Ablauf des Beispieltestmodus:

  1. Der Hersteller nimmt ein Gerät (wahrscheinlich im Versandzustand verpackt) aus dem Werk/Lager und startet das Gerät im WinRE (Wiederherstellungsbetriebssystem).
  2. Der Hersteller führt einen von Microsoft bereitgestellten Befehl auf dem Gerät mit dem installierten Windows-Image aus, um den Feature-/Filtertreiber zu aktivieren. Der Techniker startet dann das Gerät, um einen Endbenutzer zu simulieren und Qualitätsprüfungen durchzuführen (z. B. vollständiges OOBE, Herstellen einer Internetverbindung, Herunterladen/Installieren von Updates, Funktionen installieren usw.).
  3. Nach Abschluss des Tests startet der Hersteller den Computer in WinRE und führt einen weiteren Befehl aus, um das Gerät in seinen ursprünglichen Zustand vor der ersten Benutzererfahrung (OOBE) zurückzustellen. Der Vorgang zum Zurücksetzen des Geräts ist im Vergleich zur Neuinstallation des Betriebssystems deutlich schneller.
  4. Das Ergebnis wäre ein Windows-Image, das mit dem Zustand vor der Windows-Willkommensseite identisch ist. Der Hersteller schaltet das Gerät dann aus und macht es für den Versand bereit.

Beispieltestmodusversionen

Der Beispieltestmodus wird nur für Client-Windows-Editionen unterstützt. Siehe unten für Windows-Version.

Windows-Version Freigabe
Windows 11 24H2

Befehlszeilen

Um in den Beispieltestmodus zu wechseln, starten Sie Ihren Computer ohne vorgenommene Änderungen, und starten Sie ihn in WinRE. Die folgenden DISM-Befehle werden dann zum Aktivieren und Wiederherstellen von Änderungen verwendet.

Befehlszeilen BESCHREIBUNG Voraussetzung
/Start-DUTMode Starten des Testmodus nach dem Starten in WinRE
  1. Das Layout der Datenträgerpartition ist das unterstützte Standardlayout.
  2. BitLocker ist deaktiviert, und der Datenträger wird vollständig entschlüsselt.
  3. Das System wird ohne Benutzerprofile auf der Windows-Willkommensseite zurückgesetzt.
/Revert-DUTMode Änderungen, die während des Testmodus vorgenommen wurden, wiederherstellen, damit der Computer in den ursprünglichen Zustand zurückkehrt
  1. BitLocker ist deaktiviert und der Datenträger vollständig entschlüsselt (Vor /Revert-DUTMode verwenden Sie "manage-bde", um den BitLocker-Status abzurufen und die Betriebssystempartition vollständig zu entschlüsseln.)
  2. Es wurde keine Partition formatiert.
  3. Kein unerwarteter oder erzwungener Neustart oder Herunterfahren des Geräts
  4. Das Gerät konnte nicht mit einer nicht unterstützten Umgebung gestartet werden, z. B. das Gerät, das mit WinPE gestartet wurde, das nicht über das STM-Feature verfügt, und der Treiber ist aktiviert. Weitere Informationen zur unterstützten und nicht unterstützten Umgebung finden Sie unten unter "Support auf Datenträgerpartition".
  5. STM-Treiber "WinSetupBak" wurde vom Benutzer nicht manuell entladen oder entfernt.
  6. Während des Beispieltests wurde kein Featureupdate auf dem Gerät durchgeführt.
  7. Die Windows-Wiederherstellungspartition (WinRE) wurde von Windows Update nicht neu dimensioniert. Es sollten keine Änderungen an WinRE vorgenommen werden.

Verwendungshandbuch für den Beispieltestmodus

So starten Sie den Beispieltestmodus

  1. Zum OOBE-Bildschirm booten
  2. Drücken Sie STRG-UMSCHALT-F5, um den Computer mit dem Wiederherstellungsbetriebssystem neu zu starten.
  3. Wählen Sie "Problembehandlung" "Erweiterte Optionen" >> "Eingabeaufforderung" aus, dies sollte ein cmd.exe Fenster öffnen.
  4. Führen Sie den DISM-Befehl aus, um den DUT-Modus zu aktivieren: dism.exe/Start-DUTMode
DISM.exe /Start-DUTMode
  1. Die Maschine ist nun bereit zum Testen mit dem angeschlossenen und laufenden Filtertreiber (WinSetupBak). Sie können fltmc.exe ausführen, um den Treiber(WinSetupBak) am unteren Rand des Stapels anzuzeigen.
DISM.exe /fltmc.exe 

So stellen Sie änderungen zurück, die während des Tests vorgenommen wurden

Von Bedeutung

Bevor Sie das Wiederherstellungsverfahren starten, stellen Sie sicher, dass Sie "manage-bde" verwenden, um den BitLocker-Status zu erhalten und die Betriebssystempartition vollständig zu entschlüsseln und BitLocker zu deaktivieren.

  1. Wenn Sie bereit sind, die Geräte in den ursprünglichen Zustand wiederherzustellen, wechseln Sie zur App "Einstellungen".
  2. Auf der Registerkarte "System" auf der rechten Seite nach unten zur Kachel "Wiederherstellung" scrollen und darauf klicken.
  3. Klicken Sie auf der Kachel "Erweiterter Start" auf die Schaltfläche "Jetzt neu starten". Der Computer sollte nun mit dem Wiederherstellungsbetriebssystem neu gestartet werden.
  4. Wählen Sie "Problembehandlung" "Erweiterte Optionen" >> "Eingabeaufforderung" aus, dies sollte ein cmd.exe Fenster öffnen.
  5. Führen Sie den DISM-Befehl aus, um den DUT-Modus wiederhergestellt zu können: dism.exe/Revert-DUTMode
DISM.exe /Revert-DUTMode
  1. Es sollte eine Statusleiste und die Bestätigung angezeigt werden, dass der Befehl erfolgreich abgeschlossen wurde.

Problembehandlung von STM

Wo finden Sie STM-Protokolldateien

In diesem Abschnitt wird erläutert, wo sie die erforderlichen Protokolldateien basierend auf dem Ergebnis Ihres Vorgangs finden.

Erfolgreiche Wiederherstellung

Wenn der Wiederherstellungsvorgang erfolgreich war, finden Sie alle relevanten Protokolldateien im folgenden Verzeichnis:

  • X:\Windows\Logs\DISM

Problembehandlung bei Fehlern:

Sammeln Sie die folgenden Protokolldateien für Problembehandlungszwecke basierend auf dem jeweiligen Fehlerszenario:

  • Fehler beim Starten des DUT-Modus: Sammeln von Protokollen von:
    • X:\Windows\Logs\DISM
  • Fehler beim Rücksetzen des DUT-Modus: Sammeln Sie die Protokolle unmittelbar nachdem das Zurücksetzen fehlgeschlagen ist von:
    • X:\Windows\Logs\DISM
    • C:\$WINDOWS.~BK\WinSetupBak.log
    • C:\$WINDOWS.~BK\Operations.jrn

Erweiterte Problembehandlung (ausführliche Protokollierung):

Um bei der Behebung komplexer Probleme zu helfen, sind ausführlichere Protokolle erforderlich.

  1. Legen Sie die Umgebungsvariable WINSETUPBAK_VERBOSE=1fest, bevor Sie das Problem wiedergeben.
  2. Sammeln Sie die Protokolldateien, wie im Abschnitt "Problembehandlungsfehler" beschrieben, die für Ihr Szenario relevant sind.

Wichtiger Hinweis: Durch aktivieren der ausführlichen Protokollierung werden sehr große Protokolldateien (potenziell über 1 GB) generiert und die Systemleistung kann verlangsamt werden. Verwenden Sie diese Option nur, wenn sie speziell für eingehende Untersuchungen erforderlich ist.

Unterstützung für Festplattenpartitionen

Datenträgerpartitionslayout

Die erste Version dieses Features unterstützt nur das folgende Partitionslayout:

  1. Einzelner Datenträger
  2. Standard-UEFI-Partitionslayout: EFI-System-, MSR-, Windows- und Wiederherstellungspartitionen

Änderungen am Gerät

Die erste Version dieses Features unterstützt nur das Wiederherstellen von Änderungen an den folgenden Partitionen:

  1. EFI-System
  2. Fenster
  3. Wiederherstellung

Alle anderen Änderungen am Zustand des Geräts, einschließlich der folgenden, werden nicht unterstützt und können nicht wiederhergestellt werden:

  1. Änderungen an Datenträgern und Partitionen außerhalb des unterstützten Datenträgerpartitionslayouts und der unterstützten Partitionen.
  2. Neu erstellte Dateien und Änderungen an den neuen Dateien in der WinRE- und EFI-Systempartition werden nicht unterstützt, und vorgenommene Änderungen sind unwiderruflich. Änderungen an vorhandenen Dateien können jedoch mit /Revet-DUTMode rückgängig gemacht werden.
  3. Partition unter /Start-DUTMode hinzugefügt oder entfernt
  4. Änderungen am UEFI-Zustand des Geräts
  5. Änderungen am Firmwarestatus des Geräts

Häufig gestellte Fragen

Welche Einschränkungen bestehen bei dieser Funktion?

Änderungen am Gerät, das vom Feature NICHT wiederhergestellt werden:

  1. Änderungen am Inhalt aller Partitionen außerhalb der MainOS-, EFI- und WINRE-Partitionen. Derzeit vorgenommene Änderungen in WinRE- und EFI-Partitionen können wiederhergestellt werden, aber nicht, wenn neue Dateien erstellt, geändert und gelöscht werden. Weitere Informationen finden Sie im Abschnitt "Bekannte Probleme".
  2. Änderungen an der Firmware.
  3. Dienstseitige Änderungen, die während des Beispieltestverfahrens mit Clouddiensten vorgenommen wurden.

Wie wissen wir, dass sich das Gerät im Beispieltestmodus befindet?

Es wurde ein Wasserzeichen geplant, das im Betriebssystem angezeigt wird, um anzugeben, wann sich ein Gerät in STM befindet. Um ein Gerät im STM-Modus zu identifizieren, können Sie fltmc.exe ausführen, um den Treiber (WinSetupBak) am unteren Rand des Stapels anzuzeigen.

Was sind die bekannten Probleme ab jetzt?

  1. In einigen Fällen ist, nachdem sichergestellt wurde, dass BitLocker entschlüsselt ist, der Start in WinRE erfolgt ist und der Befehl DISM /Revert-DUTMode ausgeführt wurde, ein zusätzlicher Ordner "$Windows.~BK" auf dem Datenträger vorhanden. Dies ist ein bekanntes Bereinigungsproblem, das wir in einer der nächsten Versionen beheben möchten.
  2. Neu erstellte Dateien und Änderungen an den neuen Dateien in der WinRE- und EFI-Systempartition werden nicht unterstützt, und vorgenommene Änderungen sind unwiderruflich. Änderungen an vorhandenen Dateien können jedoch mit /Revet-DUTMode rückgängig gemacht werden. Wir arbeiten daran, das Problem durch die nächsten Versionen zu beheben.