2024年6月10日发(作者：)

ImageX

命令行选项

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

imagex [flags] {/append | /apply | /capture | /delete | /dir | /export | /info | /split |

/mount | /mountrw | /unmount} [parameters]

要点：必须分别运行其中的每个命令行选项。如果没有为捕获的 .wim 文件提供位置，则该过程将在

ImageX 目录中自动创建一个位置。例如：如果您在使用/capture选项时输入，而不是

D:，则文件将出现在 ImageX 目录中。

ImageX

命令行选项

操作 描述

将卷映像附加到现有的 Windows 映像 (.wim) 文件中。创建

该文件的个别实例，将其与 .wim 文件中已存在的资源进行比

较，以便不会重复捕获同一个文件。

要点：必须从 Windows 预安装环境 (Windows PE) 运行此

选项。此外，还必须确保有足够的磁盘空间可用于运行/append

选项。如果在运行/append选项期间磁盘空间不足，则可能会损

坏已附加的 .wim 文件。

要点：.wim 文件只能使用一种指定的压缩类型，因此，只能附加

压缩类型相同的文件。

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

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

"description" 指定提供其他参考信息的文本。必须使用直引

号。

还可以设置以下选项：

/boot将卷映像标记为可启动。此选项仅适用于 Windows PE

映像。在 .wim 文件中，只能将一个卷映像标记为可启动。

/check检查 .wim 文件的完整性。如果未提供该选项，则将取

消现有检查。

/configconfiguration_指定配置文件的名称和位置。

必要时，可以重命名此文件。

/scroll滚动输出以进行重定向。

/verify通过检查错误和文件重复，可以进行文件资源验证。

例如：imagex /append d:d:

"Drive D" /verify

将卷映像应用于指定的驱动器。

要点：必须从 Windows PE 运行此选项。

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

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

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

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

在开始此过程之前，必须先创建所有的硬盘分区，除非您使用脚本

运行此选项。如果对目录结构使用/apply选项，则该选项将包含

指定的目录，包括所有的子目录和文件。

要点：对于/apply选项，必须包括父目录。否则，在应用映像时，

此映像将覆盖该位置中的所有内容。例如：如果将映像应用到驱动

器 C，则/apply选项将覆盖包含映像文件的驱动器 C 中存在的

所有内容。若要自动创建目录，则在执行imagex /apply之前，

必须向脚本中添加mkdirtarget_directory命令。

还可以设置以下选项：

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

除现有检查。

/启用对拆分的 .wim 文件 (SWM) 的

引用。是其他拆分文件的名称和位置。可以使用

通配符。

imagex

/appendimage_path

image_file

{"description"}{/boot |

/check |

/configconfiguration_

i | /scroll | /verify}

imagex /applyimage_file

image_numberimage_name

image_path {/check | /ref |

/scroll | /verify}

/scroll滚动要重定向的输出。

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

例如：imagex /apply d: 1

d:New_Directory /verify

将某个驱动器的卷映像捕获到新的 .wim 文件。捕获的目录包括

所有子文件夹和数据。不能捕获空目录。目录必须至少包含一个文

件。

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

忽略扩展属性。

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

请使用/compress选项。

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

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

"name" 指定新的 .wim 文件的名称。此值是必需的。必须

使用直引号。

"description" 指定提供其他参考信息的文本。该值是可选

的。必须使用直引号。

还可以设置以下选项：

/boot将卷映像标记为可启动。仅适用于 Windows PE 映像。

在 .wim 文件中，只能将一个卷映像标记为可启动。

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

除现有检查。

/compress [maximum | fast | none] 指定最初的捕获

操作使用的压缩类型。maximum选项提供了最佳压缩效果，但

是捕获映像所用的时间最长。fast选项提供更快速的映像压缩，

但生成的文件比使用maximum选项压缩的文件大。这也是默认

压缩类型，在将此参数保留为空时使用。none选项不会压缩捕获

的映像。

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

很小。

/configconfiguration_指定配置文件的名称和位置。

必要时，可以重命名此文件。

注意：如果将 Configuration_ 文件重命名为

并将其存储在 ImageX 目录（

文件所在的位置）中，则运行/capture选项时该文件将自动运行，

而不会要求您使用/config选项。

/flags "EditionID" 指定要捕获的Windows 的版本。如

果您打算使用 Windows 安装程序重新部署自定义

，则需要/flags值。需要使用直引号。如果使用

ImageX 部署映像，则不需要此标志。有效的 EditionID 值包

括：

HomeBasicHomePremiumStarterUltimateBusiness

EnterpriseServerDatacenterServerEnterpriseServe

rStandard

/norpfix禁用重分析点标记修正。如果设置此选项，则不会捕获

解析为 image_path 以外路径的重分析点。

/scroll滚动要重定向的输出。

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

注意：/verify选项将影响总捕获时间。捕获操作期间，进度栏仅

表明捕获操作的状态，而是验证操作的状态。捕获完成后，则开始

验证过程。此过程需要一段时间，即使进度栏显示 100% 也是如

此。

例如：

imagex /capture d:d: "Drive D"

/verify

imagex /compress fast /flags "Ultimate" /check

/scroll /capture c:d: "Windows Vista

imagex

/captureimage_path

image_file "name"

{"description"} {/boot |

/check | /compress [type] |

/config | /flags "EditionID"

| /norpfix | /scroll |

/verify}