ImageX (Befehlszeilenoptionen)
Betrifft: Windows Vista
ImageX ist ein Befehlszeilentool in Windows Vista, mit dem Sie Windows-Abbilddateien (WIM-Dateien) erstellen und verwalten können. Eine WIM-Datei enthält ein oder mehrere Volumeabbilder – Datenträgervolumes, die Abbilder eines installierten Windows-Betriebssystems enthalten.
Zum Ändern der Volumeabbilder müssen Sie den Windows-Abbilddatei-Systemfiltertreiber (Windows Imaging File System Filter, WIM FS-Filter) auf einem Computer unter Windows XP mit Service Pack 2 (SP2), Windows Server 2003 mit Service Pack 1 (SP1) oder Windows Vista installieren. Wenn Sie den WIM FS-Filtertreiber installiert haben, können Sie eine WIM-Datei wie ein Verzeichnis bereitstellen und die Volumeabbilder über ein Verwaltungstool wie beispielsweise Windows Explorer durchsuchen, kopieren, einfügen und bearbeiten, ohne das Abbild zu extrahieren und erneut zu erstellen.
Wichtig |
|---|
| Sie müssen alle Befehlszeilenoptionen einzeln ausführen. Wenn Sie keinen Speicherort für die erfasste WIM-Datei bereitstellen, wird diese vom Prozess automatisch im ImageX-Verzeichnis erstellt. Wenn Sie beispielsweise Data.wim anstelle von D:\Imaging\Data.wim eingeben und die Option /capture verwenden, wird die Datei Data.wim im ImageX-Verzeichnis angezeigt. |
ImageX (Befehlszeilenoptionen)
ImageX (Befehlszeilenoptionen) verwenden folgende Konventionen:
imagex [flags] {/append | /apply | /capture | /delete | /dir | /export | /info | /split | /mount | /mountrw | /unmount} [Parameter]
Die folgende Liste zeigt die gültige Syntax, die für den jeweiligen imagex-Operationstyp verwendet wird.
imagex /append Abbildpfad Abbilddatei {"Beschreibung"} {/boot | /check | /configKonfigurationsdatei.ini | /scroll | /verify}
imagex /apply Abbilddatei Abbildnummer Abbildname Abbildpfad {/check | /ref | /scroll | /verify}
imagex /capture Abbildpfad Abbilddatei "Name" {"Beschreibung"} {/boot | /check | /compress [Typ] | /config | /flags "Editions-ID" | /norpfix | /scroll | /verify}
imagex /delete Abbilddatei Abbildnummer Abbildname {/check}
imagex /dir Abbilddatei Abbildnummer Abbildname
imagex /export Quelldatei Quellnummer Quellname Zieldatei Zielname {/boot | /check | /compress [Typ] | /ref [splitwim.swm]}
imagex /info Abbilddatei[Abbildnummer | Abbildname] [neuer Name] [neue Beschreibung] {/boot | /check}
imagex /mount Abbilddatei Abbildnummer Abbildname Abbildpfad {/check}
imagex /mountrw Abbilddatei Abbildnummer Abbildname Abbildpfad {/check}
imagex /split Abbilddatei Zieldatei Größe {/check}
imagex /unmount Abbildpfad {/commit}
| Vorgang | Beschreibung | ||||||||
|---|---|---|---|---|---|---|---|---|---|
|
imagex /append Abbildpfad Abbilddatei {"Beschreibung"} {/boot | /check | /configKonfigurationsdatei.ini | /scroll | /verify} |
Hängt ein Volumeabbild an eine vorhandene Windows-Abbilddatei (WMI-Datei) an. Erstellt eine einzelne Instanz der Datei und vergleicht diese mit der bereits in der WIM-Datei vorhandenen Ressourcen, so dass Sie nicht dieselbe Datei zweimal erfassen müssen.
Abbildpfad Gibt den Namen und den Speicherort der vorhandenen anzuhängenden WIM-Datei an. Abbilddatei Gibt den Namen und den Speicherort des Volumeabbilds an, das an die vorhandene Datei angehängt wird. "Beschreibung" Gibt den Text an, der zusätzliche Referenzinformationen enthält. Die geraden Anführungszeichen sind erforderlich. Sie können auch die folgenden Optionen festlegen: /boot Kennzeichnet ein Volumeabbild als startbar. Diese Option gilt nur für Windows PE-Abbilder. Es kann nur ein Volumeabbild in einer WIM-Datei als startbar gekennzeichnet werden. /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. /config Konfigurationsdatei.ini Gibt den Namen und den Speicherort der Konfigurationsdatei an. Die Datei kann nach Bedarf umbenannt werden. /scroll Führt in der Ausgabe einen Bildlauf für die Umleitung aus. /verify Ermöglicht eine Überprüfung der Dateiressourcen durch die Prüfung auf Fehler und Dateiduplikate. Beispiel: imagex /append d: d:\imaging\data.wim "Drive D" /verify |
||||||||
|
imagex /apply Abbilddatei Abbildnummer AbbildnameAbbildpfad {/check | /ref | /scroll | /verify} |
Weist ein Volumeabbild einem bestimmten Laufwerk zu.
Abbilddatei Gibt den Namen und den Speicherort des Volumeabbilds an, das auf das Verzeichnis angewendet wird. Abbildnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist. Abbildname Gibt den Namen an, der das Abbild in der WIM-Datei identifiziert. Abbildpfad Gibt den Dateipfad an, in dem das Abbild angewendet wird. Sie müssen vor Beginn dieses Prozesses alle Festplattenpartitionen erstellen, sofern Sie diese Option nicht mithilfe eines Skripts ausführen. Wenn Sie die Option /apply für eine Verzeichnisstruktur verwenden, berücksichtigt die Option das angegebene Verzeichnis einschließlich aller Unterverzeichnisse und Dateien.
Sie können auch die folgenden Optionen festlegen: /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. /ref Splitwim.swm Aktiviert den Verweis auf geteilte WIM-Dateien (SWMs). Splitwim.swm ist der Name und Speicherort weiterer geteilter Dateien. Platzhalterzeichen sind zulässig. /scroll Führt in der Ausgabe einen Bildlauf für die Umleitung aus. /verify Ermöglicht eine Überprüfung der Dateiressourcen durch die Prüfung auf Fehler und Dateiduplikate. Beispiel: imagex /apply d:\imaging\data.wim 1 d:\New_Directory /verify |
||||||||
|
imagex /capture Abbildpfad Abbilddatei "Name" {"Beschreibung"} {/boot | /check | /compress [Typ] | /config | /flags "Editions-ID" | /norpfix | /scroll | /verify} |
Erfasst ein Volumeabbild von einem Laufwerk in einer neuen WIM-Datei. Zu den erfassten Verzeichnissen gehören alle Unterordner und Daten. Sie können kein leeres Verzeichnis erfassen. Ein Verzeichnis muss mindestens eine Datei enthalten.
Während des Erfassungsvorganges wird automatisch die schnelle Komprimierung angewendet. Wenn Sie einen anderen Komprimierungstyp benötigen, verwenden Sie die Option /compress. Abbildpfad Gibt den Namen und den Speicherort des Volumeabbilds für die Erfassung an. Abbilddatei Gibt den Namen und den Speicherort der neuen WIM-Datei an. "Name" Gibt den Namen der WIM-Datei an. Dieser Wert ist erforderlich. Die geraden Anführungszeichen sind erforderlich. "Beschreibung" Gibt den Text an, der zusätzliche Referenzinformationen enthält. Dieser Wert ist optional. Die geraden Anführungszeichen sind erforderlich. Sie können auch die folgenden Optionen festlegen: /boot Kennzeichnet ein Volumeabbild als startbar. Nur für Windows PE-Abbilder verfügbar. Nur ein Volumeabbild innerhalb einer WIM-Datei kann als startbar gekennzeichnet werden. /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. /compress [maximum | fast | none] Gibt den für den anfänglichen Erfassungsvorgang verwendeten Komprimierungstyp an. Die Option maximum bietet die beste Komprimierung, beansprucht jedoch die meiste Zeit beim Erfassen des Abbilds. Die Option fast bietet eine schnellere Abbildkomprimierung, jedoch sind die sich ergebenden Dateien größer als mit der Option maximum komprimierte Dateien. Dies ist auch der Standardkomprimierungstyp, der verwendet wird, wenn Sie diesen Parameter leer lassen. Mit der Option none wird das erfasste Abbild nicht komprimiert.
/config Konfigurationsdatei.ini Gibt den Namen und den Speicherort der Konfigurationsdatei an. Die Datei kann nach Bedarf umbenannt werden.
/flags "Editions-ID" Gibt die Windows-Version an, die Sie erfassen wollen. Der Wert /flags Ist erforderlich, wenn Sie eine benutzerdefinierte Install.wim erneut mit Windows Setup bereitstellen möchten. Die geraden Anführungszeichen sind erforderlich. Dieses Flag ist nicht erforderlich, wenn Sie das Abbild mithilfe von ImageX bereitstellen. Gültige Editions-IDs sind: HomeBasic HomePremium Starter Ultimate Business Enterprise ServerDatacenter ServerEnterprise ServerStandard /norpfix Deaktiviert die Korrektur von Analysepunkttags. Wenn diese Option festgelegt ist, werden Analysepunkte, die in Pfade außerhalb des Abbildpfads aufgelöst werden, nicht erfasst. /scroll Führt in der Ausgabe einen Bildlauf für die Umleitung aus. /verify Aktiviert die Überprüfung der Dateiressourcen durch Überprüfen auf Fehler und Dateiduplikate.
Beispiel: imagex /capture d: d:\imaging\data.wim "Drive D" /verify imagex /compress fast /flags "Ultimate" /check /scroll /capture c: d:\install.wim "Windows Vista Ultimate" |
||||||||
|
imagex /delete AbbilddateiAbbildnummerAbbildname{/check} |
Löscht das angegebene Volumeabbild aus einer WIM-Datei mit mehreren Volumeabbildern. Mit dieser Option werden nur die Metadaten- und XML-Einträge gelöscht. Es werden keine Stromdaten gelöscht, und die WIM-Datei wird nicht optimiert. Sobald die Datei bereitgestellt ist, können Sie alle im Verzeichnis enthaltenen Informationen anzeigen, jedoch nicht ändern. Wenn Sie keine Parameter für die Bereitstellung angeben, listet die Option alle bereitgestellten Abbilder auf. Abbilddatei Gibt den Namen und den Speicherort der für die Löschung angegebenen WIM-Datei an. Abbildnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist.
Abbildname Gibt den Namen an, der auf das Abbild in der WIM-Datei verweist. Sie können auch die folgende Option festlegen: /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. Beispiel: imagex /delete d:\imaging\data.wim 1 |
||||||||
|
imagex /dir AbbilddateiAbbildnummerAbbildname |
Zeigt eine Liste der Dateien und Ordner innerhalb eines bestimmten Volumeabbildes an. Abbilddatei Gibt den Namen und den Speicherort des Volumeabbilds für die Überprüfung an. Wenn Sie kein Volumeabbild bereitstellen, gibt die Option eine Verzeichnisliste aller Volumeabbilder in der WIM-Datei zurück. Abbildnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist. Abbildname Gibt den Namen an, der auf das Abbild in der WIM-Datei verweist. Beispiel: imagex /dir d:\imaging\data.wim 1 |
||||||||
|
imagex /export QuelldateiQuellnummerQuellname Zieldatei Zielname {/boot | /check | /compress [Typ] | /ref [splitwim.swm]} |
Exportiert eine Kopie der angegebenen WIM-Datei in eine andere WIM-Datei. Quell- und Zieldatei müssen denselben Komprimierungstyp verwenden. Sie können ein Abbild auch optimieren, indem Sie es in eine neue Abbilddatei exportieren. Wenn Sie ein Abbild ändern, speichert ImageX zusätzliche Ressourcendateien, durch die sich die Gesamtgröße des Abbilds erhöht. Beim Exportieren des Abbilds werden nicht benötigte Ressourcendateien entfernt.
Quelldatei Gibt den Dateipfad der WIM-Datei an, die das zu kopierende Abbild enthält. Quellnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist. Quellname Gibt den Namen an, der das Abbild in der WIM-Quelldatei identifiziert. Zieldatei Gibt den Dateipfad der WIM-Datei an, die das zu kopierende Abbild erhalten soll. Zielname Gibt den eindeutigen Namen für das Abbild in der WIM-Zieldatei an. Sie können auch die folgenden Optionen festlegen: /boot Kennzeichnet ein Volumeabbild als startbar. Nur für Windows PE-Abbilder verfügbar. Nur ein Volumeabbild innerhalb einer WIM-Datei kann als startbar gekennzeichnet werden. /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. /compress [maximum | fast | none] Gibt den für den anfänglichen Erfassungsvorgang verwendeten Komprimierungstyp an. Die Option maximum bietet die beste Komprimierung, beansprucht jedoch die meiste Zeit beim Erfassen des Abbilds. Die Option fast bietet eine schnellere Abbildkomprimierung, jedoch sind die sich ergebenden Dateien größer als mit der Option maximum komprimierte Dateien. Dies ist auch der Standardkomprimierungstyp, der verwendet wird, wenn Sie diesen Parameter leer lassen. Mit der Option none wird das erfasste Abbild nicht komprimiert. /ref splitwim.swm Aktiviert den Verweis auf geteilte WIM-Dateien (SWMs). Splitwim.swm ist der Name und Speicherort weiterer geteilter Dateien. Platzhalterzeichen sind zulässig. Beispiel: imagex /export d:\imaging\data.wim d:\imaging\sample.wim 1 |
||||||||
|
imagex /info Abbilddatei[Abbildnummer | Abbildname] [neuer Name] [neue Beschreibung] {/boot | /check} |
Gibt die gespeicherten XML-Beschreibungen für die angegebene WIM-Datei zurück, darunter u. a. die Gesamtdateigröße, die Abbildindexnummer, die Verzeichnisanzahl, die Dateianzahl und eine Beschreibung. Abbilddatei Gibt den Namen und den Speicherort der WIM-Datei für die Überprüfung der XML-Daten an. Abbildnummer Gibt die Nummer an, die ein Abbild in der WIM-Datei identifiziert. Abbildname Gibt den Namen an, der ein Abbild in der WIM-Datei identifiziert. Neuer_Name Gibt den neuen eindeutigen Namen für das angegebene Abbild an. Neue_Beschreibung Gibt die neue Beschreibung für das angegebene Abbild an. Sie können auch die folgenden Optionen festlegen: /boot Kennzeichnet ein Volumeabbild als startbar. Nur für Windows PE-Abbilder verfügbar. Nur ein Volumeabbild innerhalb einer WIM-Datei kann als startbar gekennzeichnet werden. /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. Beispiel: imagex /info d:\imaging\data.wim |
||||||||
|
imagex /mount AbbilddateiAbbildnummerAbbildnameAbbildpfad {/check} |
Stellt eine WIM-Datei aus Windows XP mit Service Pack 2 (SP2), Windows Server 2003 mit Service Pack 1 (SP1) oder Windows Vista mit Leseberechtigung in einem angegebenen Verzeichnis breit. Sobald die Datei bereitgestellt ist, können Sie alle im Verzeichnis enthaltenen Informationen anzeigen, jedoch nicht ändern.
Abbilddatei Gibt den Pfad der WIM-Datei an, die das angegebene Abbild enthält. Abbildnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist. Abbildname Gibt den Namen an, der auf das Abbild in der WIM-Datei verweist. Abbildpfad Gibt den Dateipfad an, in dem das angegebene Abbild bereitgestellt wird. Sie können auch das folgende Flag festlegen: /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. Beispiel: imagex /mount d:\imaging\data.wim 2 c:\mounted_images |
||||||||
|
imagex /mountrw Abbilddatei Abbildnummer Abbildname Abbildpfad {/check} |
Stellt eine WIM-Datei aus Windows XP mit Service Pack 2 (SP2), Windows Server 2003 mit Service Pack 1 (SP1) oder Windows Vista mit Lese- und Schreibberechtigung in einem angegebenen Verzeichnis breit. Sobald die Datei bereitgestellt ist, können Sie alle im Verzeichnis enthaltenen Informationen anzeigen und ändern.
Für die Option /mountrw ist exklusiver Zugriff auf die WIM-Datei erforderlich; daher können Sie die Option /mountrw nicht verwenden, wenn ein Abbild zurzeit mithilfe der Option /mount oder /mountrw bereitgestellt ist.
Abbilddatei Gibt den Namen und den Speicherort der bereitzustellenden WIM-Datei mit Lese- und Schreibberechtigung an. Abbildnummer Gibt die Zahl an, die auf das spezifische Volume in der WIM-Datei verweist. Abbildname Gibt den Namen an, der auf das Abbild in der WIM-Datei verweist. Abbildpfad Gibt den Dateipfad an, in dem das angegebene Abbild bereitgestellt wird. Sie können auch die folgende Option festlegen: /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. Beispiel: imagex /mountrw d:\imaging\data.wim 2 c:\mounted_images |
||||||||
|
imagex /split Abbilddatei Zieldatei Größe {/check} |
Teilt eine vorhandene WMI-Datei in mehrere geteilte schreibgeschützte WIM-Dateien (SWM) auf.
Abbilddatei Gibt den Namen und den Speicherort der aufzuteilenden WIM-Datei an. Zieldatei Gibt den Dateipfad der aufgeteilten Dateien an. Größe Gibt die maximale Größe der einzelnen erstellten Dateien in MB an. Die Option generiert die SWM-Dateien im angegebenen Verzeichnis und benennt jede Datei genau wie die angegebene Abbilddatei, jedoch mit einer angehängten Nummer und der Dateinamenerweiterung .swm. Wenn Sie sich beispielsweise entscheiden, eine Datei mit dem Namen Data.wim aufzuteilen, erstellt diese Option eine Datei Data.swm, eine Datei Data2.swm, eine Datei Data2.swm usw. und definiert so jeden Teil der geteilten WIM-Datei. Sie können auch die folgende Option festlegen: /check Überprüft die Integrität der WIM-Datei. Wenn diese Option nicht angegeben ist, werden vorhandene Überprüfungen entfernt. Beispiel: imagex /split d:\imaging\data.wim 600 |
||||||||
|
imagex /unmount Abbildpfad {/commit} |
Hebt die Bereitstellung des bereitgestellten Abbildes aus einem angegebenen Verzeichnis auf.
Abbildpfad Gibt den vollständigen Verzeichnisspeicherort zum Aufheben der Bereitstellung der Dateien an. Wenn Sie kein Verzeichnis angeben, listet die Option alle bereitgestellten Abbilder auf.
Beispiel: imagex /unmount /commit c:\mounted_images |
/verify und /check (Optionen)
Con den Optionen /verify und /check wird Unterstützung von Dateiüberprüfung und Datenintegrität für .wim-Dateien zur Verfügung gestellt.
DieOption /verify überprüft Cacheeinträge und sucht nach Fehlern und doppelt vorhandene Dateien. Die Option /verify unterstützt nicht das Leeren von Datenträgern, Durchschreib- oder Bypass-systemcaching. Während einer Aufzeichnungsoperation liest die Option /verify die aufgezeichnete Datei gegen und vergleicht diese, Byte für Byte mit dem Original der aufgezeichneten Datei. Während eines Anwendungsvorgangs führt die Option /verify einen Hash der angewendeten Datei durch und vegleicht diese mit dem Hashwert, der während eines Aufzeichnungsvorgangs generiert wurde.
Die Option /check wurde entwickelt, um eine Beschädigung einer .wim-Datei aufzuspüren. Wenn die Option /check während eines Aufzeichnungsvorgangs nicht festgelegt wurde, wird die Kennzeichnung während eines Anwendungsvorgangs nicht beachtet. Während eines Aufzeichnungsvorgangs generiert die Option /check einige Hashwerte und speichert diese für jeden Datenblock der .wim-Datei. Während eines Anwendungsvorgangs führt die Option /check einen Hash durch und überprüft 10 MB-Blocks gegen den während des Aufzeichnungsvorgangs gespeicherten Hashwert.
Die Optionen /verify und /check beeinflussen die Leistung bei den Anwendungsvorgängen. Es ist empfehlenswert, beide Optionen /verify und /check für optimale Abbildüberprüfung und Datenintegrität zu verwenden.
ImageX-Fehlercodes
| Fehlercode | Beschreibung |
|---|---|
|
0 |
Erfolgreich |
|
1 |
Ungültige Befehlszeilenoption |
|
2 |
WIMGAPI-Fehler |
|
3 |
Ungültiges Konfigurationsskript |
|
4 |
Zugriff verweigert, Administratorrechte erforderlich |
Siehe auch


Wichtig
Hinweis