ImageX 命令行选项

ImageX 是 Windows® 7 中的命令行工具，可用于创建和管理 Windows 映像 (.wim) 文件。.wim 文件包含一个或多个卷映像，该卷为包含已安装的 Windows 操作系统映像的磁盘卷。

若要修改卷映像，必须在运行 Windows 7 或 Windows Server® 2008 的计算机上安装 Windows 映像文件系统筛选器（WIMMount 筛选器）驱动程序。安装了 WIMMount 筛选器驱动程序，便可以装载 .wim 文件（就像它是一个目录一样），还可以在 Windows 资源管理器等文件管理工具中浏览、复制、粘贴和编辑卷映像，而无需提取或重新创建映像。

重要信息：  
必须分别运行其中的每个命令行选项。如果没有为捕获的 .wim 文件提供位置，则该过程将在 ImageX 目录中自动创建一个位置。例如，如果您在使用 /capture 选项时输入 Data.wim，而不是 D:\Imaging\Data.wim，则 Data.wim 文件将出现在 ImageX 目录中。



ImageX 命令行选项ImageX 命令行选项使用以下约定。

imagex [flags] {/append | /apply | /capture | imagex /cleanup | /commit | /delete | /dir | /export | /info | /split | /logfile | /mount | /mountrw | /unmount} [parameters]

以下列表显示了每种 ImageX 操作类型所使用的有效语法。

imagex /append image_path image_file {"description"} {/boot | /check | /config configuration_file.ini | /scroll | /verify | /logfile }

imagex /apply image_file image_number image_name image_path {/check | /ref | /scroll | /verify | /logfile}

imagex /capture image_path image_file "name" {"description"} {/boot | /check | /compress [type] | /config | /norpfix | /scroll | /verify| /logfile}

imagex /cleanup

imagex /commit mount_path image_name {/logfile}

imagex /commit /append mount_path new_image_name {/logfile}

imagex /delete image_file image_number image_name {/check| /logfile}

imagex /dir image_file image_number image_name {/logfile}

imagex /export src_file src_number src_name dest_file dest_name {/boot | /check | /compress [type] | /ref [splitwim.swm] | /logfile}

imagex /info img_file  [img_number | img_name] [new_name] [new_desc] {/boot | /check| /logfile}

imagex /mount image_file image_number image_name image_path {/check| /logfile}

imagex /mountrw image_file image_number image_name image_path {/check| /logfile}

imagex /split image_file dest_file size {/check| /logfile}

imagex /unmount image_path {/commit| /logfile}

imagex /remount image_path {/logfile}

操作  描述  
imagex /append image_path image_file {"description"}{/boot | /check | /config configuration_file.ini | /scroll | /verify | /logfile filename.log}
将卷映像附加到现有的 Windows 映像 (.wim) 文件中。创建该文件的单个实例，将其与 .wim 文件中已存在的资源进行比较，以便不会重复捕获同一个文件。

重要信息：  
确保有足够的磁盘空间可用于运行 /append 选项。如果在运行 /append 选项期间磁盘空间不足，则可能会损坏已附加的 .wim 文件。



重要信息：  
.wim 文件只能使用一种指定的压缩类型，因此，只能附加压缩类型相同的文件。



image_path

指定要附加的现有 .wim 文件的名称和位置。

image_file

指定用于附加现有文件的卷映像的名称和位置。

"description"

指定提供其他参考信息的文本。

重要信息：  
必须使用直引号。



还可以设置以下选项：

/boot

将卷映像标记为可启动映像。此选项仅适用于 Windows PE 映像。在 .wim 文件中，只能将一个卷映像标记为可启动。

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

/config configuration_file.ini

指定配置文件的名称和位置。必要时，可以重命名此配置文件。

/NORPFIX

禁用此重分析点标记修正。重分析点是包含到文件系统中另一个文件链接的文件。如果未提供，则不会捕获解析为 image_path 以外路径的重分析点。

/scroll

滚动要重定向的输出。

/temp

指定临时文件的存储路径。

/verify

通过检查错误和文件复制，启用文件资源验证。

例如，


imagex /append D: D:\imaging\data.wim "Drive D" /verify


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /apply image_file image_number | image_name image_path {/check |/norpfix | /ref | /scroll | /temp| /verify | /logfile filename.log}
将卷映像应用于指定的驱动器。

重要信息：  
必须从 Windows PE 运行此选项。



image_file

指定应用到目录的卷映像的名称和位置。

image_number

指定 .wim 文件中特定卷的编号。

image_name

指定 .wim 文件中映像的名称。

image_path

指定将应用映像的文件路径。

在开始此过程之前，必须先创建所有的硬盘分区，除非您使用脚本运行此选项。如果对目录结构使用 /apply 选项，则该选项将包含指定的目录，包括所有的子目录和文件。

重要信息：  
对于 /apply 选项，必须包括父目录。否则，在应用映像时，此映像将覆盖该位置中的所有内容。例如，如果将映像应用到 C 驱动器，则 /apply 选项将覆盖包含映像文件的 C 驱动器中存在的所有内容。

若要自动创建目录，则在执行 imagex /apply 命令之前，必须向脚本中添加 mkdir target_directory 命令。



还可以设置以下选项：

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

/norpfix

禁用此重分析点标记修正。重分析点是包含到文件系统中另一个文件链接的文件。如果未提供，则不会捕获解析为 image_path 以外路径的重分析点。

/ref splitwim.swm

启用对拆分的 .wim 文件 (SWM) 的引用。splitwim.swm 是其他拆分文件的名称和位置。可以使用通配符。有关拆分 .wim 文件的详细信息，请参阅拆分映像。

/scroll

滚动要重定向的输出。

/temp

临时文件的存储路径。

/verify

通过检查错误和文件复制，启用文件资源验证。

例如，


imagex /apply D:\imaging\data.wim 1 D:\New_Directory /verify


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /capture image_path image_file name {"description"} {/boot | /check | /compress [type] | /config | /norpfix | /scroll | /temp | /verify| /logfile filename.log}
将某个驱动器的卷映像捕获到新的 .wim 文件。捕获的目录包括所有子文件夹和数据。不能捕获空目录。目录必须至少包含一个文件。

注意：  
ImageX 不支持扩展属性。在捕获操作期间，ImageX 将忽略扩展属性。



在捕获操作过程中将自动应用快速压缩。如果需要其他压缩类型，请使用 /compress 选项。

image_path

指定要捕获的卷映像的名称和位置。

image_file

指定新的 .wim 文件的名称和位置。

文件名

指定新的 .wim 文件的名称。

重要信息：  
此值是必需的。必须使用直引号。



"description"

指定提供其他参考信息的文本。该值是可选的。必须使用直引号。

还可以设置以下选项：

/boot

将卷映像标记为可启动映像。仅适用于 Windows PE 映像。只能将 .wim 文件中的一个卷映像标记为可启动映像。

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

/compress [maximum | fast | none]

指定对初始捕获操作使用的压缩类型。maximum 选项提供了最佳压缩效果，但是捕获映像所用的时间最长。fast 选项提供更快速的映像压缩，但生成的文件比使用 maximum 选项压缩的文件大。这也是默认压缩类型，在将此参数保留为空时使用。none 选项不会压缩捕获的映像。

注意：  
尽管所选的压缩类型会影响捕获时间，但对应用时间的影响很小。



/config configuration_file.ini

指定配置文件的名称和位置。必要时，可以重命名此文件。

注意：  
如果将 Configuration_list.ini 文件重命名为 Wimscript.ini 并将其存储在 ImageX 目录（ImageX.exe 文件所在的位置）中，则运行 /capture 选项时该文件将自动运行，而不会要求您使用 /config 选项。



/scroll

滚动要重定向的输出。

/temp

指定临时文件的存储路径。

/verify

通过检查错误和文件复制，启用文件资源验证。

注意：  
/verify 选项将影响总捕获时间。捕获操作期间，进度栏仅表明捕获操作的状态，而是验证操作的状态。捕获完成后，则开始验证过程。此过程需要一段时间，即使进度栏显示 100% 也是如此。如果正在捕获到网络位置，系统将自动使用 /verify 选项。



例如，


imagex /capture D: D:\imaging\data.wim "Drive D" /verify
imagex /compress fast /check /scroll /capture C: D:\install.wim "Windows 7"


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /cleanup
删除与已放弃的装入映像相关联的所有资源。此命令不会卸载当前已装载的映像，也不会删除可以通过 imagex /remount 命令恢复的映像。例如，


imagex /cleanup


imagex /commit {/append image name}
保存对装载的 .wim 文件的更改，而无需卸载该 .wim 文件。还可以设置以下选项：

/append

将装载的映像附加到现有 .wim 文件中。如果使用该选项，则必须为新映像指定一个名称。例如，


imagex /commit C:\mounted_images
imagex /commit /append C:\mounted_images new_image


imagex /delete image_file image_number image_name {/check | /temp| /logfile filename.log}
从包含多个卷映像的 .wim 文件中删除指定的卷映像。此选项仅删除元数据条目和 XML 条目。而不会删除流数据，也不会优化 .wim 文件。

装载文件后，即可查看该目录中的所有信息，但不能修改这些信息。如果未指定要装载的参数，则此选项将列出所有装载的映像。

image_file

指定已指定为删除的 .wim 文件的名称和位置。

image_number

指定 .wim 文件中特定卷的编号。

重要信息：  
必须从 Windows PE 运行此选项。在 .wim 文件中必须始终至少具有一个卷映像，因此，只有存在多个映像时，才可以删除卷映像。



image_name

指定引用 .wim 文件中的映像的名称。

还可以设置以下选项：

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

例如，


imagex /delete D:\imaging\data.wim 1


/temp

指定临时文件的存储路径。

imagex /dir image_file image_number image_name
显示指定卷映像中的文件和文件夹列表。

image_file

指定要查看的卷映像的名称和位置。如果未提供卷映像，则此选项将返回 .wim 文件中的所有卷映像的目录列表。

image_number

指定 .wim 文件中特定卷的编号。

image_name

指定引用 .wim 文件中的映像的名称。

例如，


imagex /dir D:\imaging\data.wim 1


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /export src_file src_number src_name dest_file dest_name {/boot | /check | /compress [type] | /ref [splitwim.swm] /temp| /logfile filename.log}
将指定 .wim 文件的副本导出到其他 .wim 文件。源文件和目标文件必须使用相同的压缩类型。也可以通过将映像导出到新的映像文件，来对该映像进行优化。如果修改映像，ImageX 将存储额外的资源文件，这会增加映像的总体大小。导出映像将删除不必要的资源文件。

重要信息：  
确保有足够的磁盘空间可用于运行 /export 选项。如果在 /export 选项运行期间磁盘空间不足，可能会损坏 Destination.wim 文件。



src_file

指定包含要复制的映像的 .wim 文件的文件路径。

src_number

指定 .wim 文件中特定卷的编号。

src_name

指定标识源 .wim 文件中的映像的名称。

dest_file

指定将接收映像副本的 .wim 文件的文件路径。

dest_name

指定目标 .wim 文件中的映像的唯一名称。

还可以设置以下选项：

/boot

将卷映像标记为可引导映像。此选项仅适用于 Windows PE 映像。只能将 .wim 文件中的一个卷映像标记为可启动映像。

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

重要信息：  
如果使用 /check 选项捕获正在导出的映像，系统将自动使用 /check 选项。



/compress [maximum | fast | none]

指定对初始捕获操作使用的压缩类型。maximum 选项提供了最佳压缩效果，但是捕获映像所用的时间最长。fast 选项提供更快速的映像压缩，但生成的文件比使用 maximum 选项压缩的文件大。这也是默认压缩类型，在将此参数保留为空时使用。none 选项不会压缩捕获的映像。

/ref splitwim.swm

启用对拆分的 .wim 文件 (SWM) 的引用。splitwim.swm 是其他拆分文件的名称和位置。可以使用通配符。

例如，


imagex /export D:\imaging\data.wim 1 D:\imaging\sample.wim


/temp

临时文件的存储路径。

/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /info img_file [img_number | img_name] [new_name] [new_desc] {/boot | /check | /temp | /xml| /logfile filename.log}
返回指定 .wim 文件的已存储的 XML 描述，包括（但不限于）总文件大小、映像索引编号、目录计数、文件计数以及描述。

image_file

指定供查看 XML 数据使用的 .wim 文件的名称和位置。

image_number

指定标识 .wim 文件中的映像的编号。

image_name

指定标识 .wim 文件中的映像的名称。

new_name

指定已指定映像的新的唯一名称。

new_desc

指定已指定映像的新描述。

还可以设置以下选项：

/boot

将卷映像标记为可启动映像。仅适用于 Windows PE 映像。只能将 .wim 文件中的一个卷映像标记为可启动映像。

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

例如，


imagex /info D:\imaging\data.wim


/temp

指定临时文件的存储路径。

/XML

指定临时文件的存储路径。

/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /mount image_file image_number image_name image_path {/check| /logfile filename.log}
从带有 Service Pack 1 (SP1) 的 Windows Server 2003、Windows Vista 或对指定目录具有只读权限的 Windows 7 中装载 .wim 文件。

装载文件后，即可查看该目录中包含的所有信息，但不能修改这些信息。

重要信息：  
装载映像之前，必须先安装 WIMMount 筛选器。



image_file

指定包含指定映像的 .wim 文件的路径。

image_number

引用 .wim 文件中特定卷的编号。

image_name

引用 .wim 文件中映像的名称。

image_path

将装载指定映像的文件路径。

还可以设置以下标志：

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

例如，


imagex /mount D:\imaging\data.wim 2 C:\mounted_images


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /mountrw image_file image_number image_name image_path {/check| /logfile filename.log}
从带有 Service Pack 1 (SP1) 的 Windows Server 2003、Windows Vista 或对指定目录具有读取/写入权限的 Windows 7 中装载 .wim 文件。

装载文件后，即可查看和修改该目录中包含的所有信息。

重要信息：  
装载映像之前，必须先安装 WIMMount 筛选器。运行 Windows 映像筛选器时禁用系统还原。将文件复制到装入点时，Windows 映像筛选器可能会失败。在 Windows Server 2003 上，对从 DVD 或 CD 装载的 Windows 映像运行 xcopy 命令可能会导致系统失败。装载期间请勿运行 xcopy 命令。



/mountrw 选项要求对 .wim 文件的独占访问权限；因此，如果当前使用 /mount 选项或 /mountrw 选项装载映像，则您不能使用 /mountrw 选项。

重要信息：  
不得将映像装载到已装载目录的父目录或子目录中。将映像装载到包含文件的目录后，现有的文件将被遮盖，直到运行 /unmount 选项为止。此外，也决不能将映像装载到 Windows 保留文件夹。



image_file

指定要以读/写权限装载的 .wim 文件的名称和位置。

image_number

指定引用 .wim 文件中的特定卷的编号。

image_name

指定引用 .wim 文件中的映像的名称。

image_path

指定将装载指定映像的文件路径。

还可以设置以下选项：

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

例如，


imagex /mountrw  D:\imaging\data.wim 2 C:\mounted_image


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /split image_file dest_file  size {/check| /logfile filename.log}
将现有的 .wim 文件拆分为多个只读的拆分 .wim 文件 (.swm)。

image_file

指定要拆分的 .wim 文件的名称和位置。

dest_file

指定已拆分文件的文件路径。

size

指定每个已创建文件的最大大小 (MB)。

此选项将在指定目录中生成 .swm 文件，使每个文件与指定的 image_file 具有相同的名称，但包含附加编号和 .swm 文件扩展名。例如，如果选择拆分名为 Data.wim 的文件，则该选项将创建 Data.swm 文件、Data2.swm 文件、Data3.swm 文件等，分别定义拆分后的 .wim 文件的每个部分。

还可以设置以下选项：

/check

检查 .wim 文件的完整性。如果未提供该选项，则将删除现有检查。

例如，


imagex /split D:\imaging\data.wim 600


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /unmount image_path {/commit| /logfile filename.log}
从指定目录卸载已装载的映像。

重要信息：  
确认有足够的硬盘空间可以为映像添加文件。执行 /commit 选项之前，必须考虑到将要向 .wim 文件中所添加文件的大小，加上因修改现有文件而使文件大小增大的量，并减去已删除的所有文件的大小。如果没有足够的硬盘空间，则将出现错误。

如果将多个映像同时装载到一个卷上的目录，则执行卸载操作的速度可能会比执行普通操作的速度慢。如果需要同时装载多个映像，建议您将这些映像装载到不同卷上的目录中。



image_path

指定要卸载文件的完整目录位置。如果未指定目录，则此选项将列出所有已装载的映像。

还可以设置以下选项：

/commit

保存对已装载映像的更改。

重要信息：  
如果使用 /unmount 选项，而不包括 /commit 选项，则将放弃所做更改。为了保存所做更改，必须使用 /mountrw 选项来装载映像，而在卸载映像时使用 /commit 选项。



/append

将装载的映像附加到现有 .wim 中。

例如，


imagex /unmount /commit C:\mounted_images


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

imagex /remount image_path {/logfile filename.log}
恢复已丢弃的装载路径。重新启动的 Windows PE 环境不支持此选项。

image_path

要重新装载的路径。如果未指定，则列出所有映像。例如，


imagex /remount C:\mounted_images


/logfile filename.log

存储 ImageX 命令事件的纯文本文件。

晕死，windows7中无这个命令