Freigeben über


REAgentC-Befehlszeilenoptionen

Sie können das Tool REAgentC.exe verwenden, um ein Windows Recovery Environment (Windows RE)-Startimage und ein Image zum Zurücksetzen auf Knopfdruck zu konfiguriere und Wiederherstellungsoptionen und Anpassungen zu verwalten. REAgentC ist in Windows enthalten, und Sie können den REAgentC-Befehl auf einem Windows-Offlineimage oder auf einem ausgeführten Windows-Betriebssystem ausführen.

Hinweis

Wenn Sie Windows PE 2.X, 3.X oder 4.X zum Konfigurieren der Wiederherstellung in einer Offlineinstallation verwenden, müssen Sie die Datei Winrecfg.exe aus dem Wiederherstellungsordner des Windows Assessment and Deployment Kit (Windows ADK) verwenden. Winrecfg.exe unterstützt nur die Offlinevorgänge, die REAgentC.exe unterstützt.

REAgentC-Syntax

reagentc.exe <command> <arguments>

/setreimage

Legt den Speicherort eines Windows RE-Startimages fest.

Unterstützt sowohl Online- als auch Offlinevorgänge.

/setreimage-Syntax

/setreimage /path <path_to_Windows_RE_image> [/target <path_to_offline_image>]

/setreimage-Verwendung

  • /path unterstützt UNC-Pfade zu Speicherorten auf dem lokalen Datenträger. Zum Beispiel:

    Reagentc /setreimage /path S:\Recovery\WindowsRE`
    
  • /target Gibt den Speicherort des Windows-Images an, wenn Sie die Einstellung offline anwenden. Zum Beispiel:

    Reagentc /setreimage /path T:\Recovery\WindowsRE /target W:\Windows
    

/enable

Aktiviert ein benutzerdefiniertes Windows RE-Startimage.

Die Option /enable wird während des speziellen Konfigurationsdurchlaufs automatisch ausgeführt. Wenn Sie kein Windows RE-Startimage angeben, versucht der Computer, Windows RE mithilfe der Standarddatei Winre.wim aus dem \Windows\System32\Recovery-Ordner zu aktivieren.

Unterstützt sowohl Online- als auch Offlinevorgänge.

/enable-Syntax

/enable [/auditmode] [/osguid <bcd_guid>]

/enable-Verwendung

  • /auditmode: Standardmäßig führt die Option /enable keine Aktionen aus, wenn Windows sich im Überwachungsmodus befindet. Um das Standardverhalten außer Kraft zu setzen und Windows RE aus dem Überwachungsmodus zu aktivieren, geben Sie die Option /auditmode an. Zum Beispiel:

    Reagentc /enable /auditmode
    

    Wenn Sie das Bild generalisieren, nachdem Sie die Option /enable im Überwachungsmodus verwendet haben, wird Windows RE deaktiviert, bis Sie die Option /enable erneut verwenden oder bis der spezialisierte Konfigurationsdurchlauf ausgeführt wird.

  • /osguid {<bcd_guid>}ermöglicht Ihnen, Ihr benutzerdefiniertes Windows RE-Startimage von Windows PE zu aktivieren. Es kann nur verwendet werden, nachdem bcdboot.exe ausgeführt wurde. <bcd_guid> ist der BCD-Bezeichner (Boot Configuration Data) der Windows-Zielinstallation, die durch Ausführen von bcdedit -enum -v abgerufen wird.

    Reagentc /enable /osguid {00000000-0000-0000-0000-000000000000}
    

/disable

Deaktiviert ein aktives Windows RE-Image, das dem Onlineimage zugeordnet ist.

Unterstützt nur Onlinevorgänge.

/disable-Verwendung

Reagentc /disable

/boottore

Gibt an, dass Windows RE beim nächsten Start des Systems automatisch gestartet wird.

Unterstützt nur Onlinevorgänge.

/boottore-Verwendung

Reagentc /boottore

/setosimage

Diese Einstellung wird nicht in Windows 10 oder höher verwendet.

Registriert die Position eines Image zum Zurücksetzen auf Knopfdruck in einem Online- oder Offlineimage. Das Wiederherstellungsimage muss im Windows-Imageformat (WIM) vorhanden sein.

Unterstützt sowohl Online- als auch Offlinevorgänge.

/setosimage-Syntax

/setosimage /path <path_to_recovery_image> /index <image_index> [/target <path_to_offline_image>]

/setosimage-Verwendung

  • Die Option /index gibt die Indexnummer des Wiederherstellungsimages an, das innerhalb einer WIM-Datei verwendet werden soll. Zum Beispiel:

    Reagentc /setosimage /path R:\RecoveryImage /index 1
    
  • Die Option /target gibt den Speicherort des Offline-Windows-Images an. Zum Beispiel:

    Reagentc /setosimage /path R:\RecoveryImage /index 1 /target W:\Windows
    

/info

Zeigt den aktuellen Status von Windows RE und jedes verfügbaren Wiederherstellungsimages in einem Online- oder Offlineimage an.

Unterstützt sowohl Online- als auch Offlinevorgänge.

/info-Syntax

/info [/target <path_to_offline_image>]

/info-Verwendung

  • /info selbst gibt den Status des Onlinebetriebssystems zurück:

    Reagentc /info
    
  • Die Option /target ruft Konfigurationsinformationen zu einem Offlineimage ab. Zum Beispiel:

    Reagentc /info /target W:\Windows
    

Registriert den Link zu einem benutzerdefinierten Tool, das im Windows Advanced-Startmenü angezeigt wird.

Unterstützt sowohl Online- als auch Offlinevorgänge.

/setbootshelllink [/configfile <path_to_BootShellXML>] [/target <path_to_offline_image>]
  • Die BootShellXML-Datei ist eine .xml-Datei, die das <BootShell>-Element und die Attribute Name und Description enthält, die im Link angezeigt werden sollen. Weitere Informationen finden Sie unter Anpassen von Windows RE:

    Reagentc /setbootshelllink /configfile F:\BootMenu\AddDiagnosticsToolToBootMenu.xml
    
  • Die Option /target gibt den Speicherort des Offline-Windows-Images an. Wenn dieses Argument nicht verwendet wird, wird das laufende Betriebssystem verwendet. Zum Beispiel:

    Reagentc /setbootshelllink /target W:\Windows
    

Windows RE-Problembehandlungsfeatures