DISM 映像管理命令行选项
部署映像服务和管理 (DISM.exe) 装载用于服务的 Windows 映像 (.wim) 文件或虚拟硬盘(.vhd 或 .vhdx)。 还可以使用 DISM 映像管理命令列出映像索引号,以验证要装载的映像的体系结构、追加映像、应用映像、捕获映像以及删除映像。 更新映像后,必须将其卸载,然后提交或丢弃所做的更改。
本主题介绍与映像管理相关的 DISM 命令。 若要查看其他命令行选项,请参阅部署映像服务和管理 (DISM) 命令行选项。 有关常见 DISM 方案的详细信息,请参阅什么是 DISM?。
除命令行工具以外,还可以通过 Windows PowerShell 来使用 DISM。 有关详细信息,请参阅 Windows PowerShell 中的 部署映像服务管理 (DISM) Cmdlet。
以下命令可用于装载、卸载、捕获、追加、删除和查询 .wim、.vhd 和 .vhdx 文件。 这些选项不区分大小写。
/Append-Image
将附加映像添加到 .wim 文件。 /Append-Image 将新文件与 /ImageFile 参数指定的现有 .wim 文件中的资源进行比较,它仅存储每个唯一文件的单个副本,以便仅捕获每个文件一次。 只能为 .wim 文件分配一种压缩类型。 因此,只能追加具有相同压缩类型的文件。
此命令行选项不适用于虚拟硬盘 (VHD) 文件。
重要
确保有足够的磁盘空间可用于运行 /Append-Image 选项。 如果在追加映像时磁盘空间不足,可能会损坏 .wim 文件。
语法:
DISM.exe /Append-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>] [/ConfigFile:<configuration_file.ini>] [/Bootable] /WIMBoot [/CheckIntegrity] [/Verify] [/NoRpFix]
参数 | 说明 |
---|---|
/WIMBoot | 使用 /WIMBoot 可以追加采用 Windows 映像文件启动 (WIMBoot) 配置的映像。 此参数仅适用于已作为 WIMBoot 文件捕获或导出的 Windows 8.1 映像。 Windows 10 及更高版本不支持此功能。 |
/ConfigFile | 指定用于列出映像捕获和压缩命令排除项的配置文件的位置。 有关详细信息,请参阅 DISM 配置列表和 WimScript.ini 文件。 |
/Bootable | 将卷映像标记为可启动映像。 此参数仅适用于 Windows 预安装环境 (WinPE) 映像。 在 .wim 文件中,只能将一个卷映像标记为可启动。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Verify | 检查有无错误和文件重复。 |
/NoRpFix | 禁用重新分析点标记修复。 重新分析点是一个文件,它包含指向文件系统中其他文件的链接。 如果未指定 /NoRpFix,将不捕获解析为 /ImageFile 所指定值范围外的路径的重分析点。 |
例如:
Dism /Append-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D
/Apply-FFU
对于 FFU,此命令将对指定的物理驱动器应用完整闪存实用工具 (FFU) 或拆分 FFU (SFU)。
语法:
/Apply-Ffu /ImageFile:<path_to_image_file> /ApplyDrive:<physical_drive_path> [/SFUFile:<pattern>]
参数 | 说明 |
---|---|
/ImageFile | 要应用的 FFU 映像文件的路径和名称 |
/ApplyDrive | 将创建映像的物理驱动器的路径 |
/SFUfile<pattern> | 可选,适用于在不压缩的情况下捕获的拆分 FFU。 使用 /SFUFile 可引用拆分 FFU 文件 (SFU)。 Pattern 是拆分文件的命名模式和位置。 指定命名模式时,请使用通配符。 例如,“E:\image\install*.sfu”将应用 E:\image 目录中所有名为 install1.sfu、install2.sfu 等的拆分文件。 |
例如:
DISM.exe /Apply-Ffu /ImageFile:flash.ffu /ApplyDrive:\\.\PhysicalDrive0
/Apply-Image
对于 WIM,此命令将对指定的分区应用 Windows 映像文件 (.wim) 或拆分的 Windows 映像 (.swm) 文件。 从 Windows 10 版本 1607 开始,DISM 可以应用和捕获扩展属性 (EA)。
对于 FFU,此命令将对指定的驱动器应用完整闪存更新 (.ffu) 映像。 它不支持从虚拟硬盘 (.vhdx) 文件应用映像,但你可以使用此命令对 VHD 应用完整映像。 FFU 仅适用于 Windows 10。 虽然可以使用此命令来应用 FFU,但请改用 /apply-ffu
。
此选项不支持从虚拟硬盘 (VHD) 应用映像,但你可以使用此命令对 .vhdx 文件应用已附加、已分区且已格式化的映像。
WIM 的参数:
DISM.exe /Apply-Image /ImageFile:<path_to_image_file> [/SWMFile:<pattern>] /ApplyDir:<target_directory> {/Index:< image_index> | /Name:<image_name>} [/CheckIntegrity] [/Verify] [/NoRpFix] [/ConfirmTrustedFile] [/WIMBoot (deprecated)] [/Compact] [/EA]
FFU 的参数
请参阅 /apply-ffu
。
参数 | 说明 |
---|---|
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Verify | 检查有无错误和文件重复。 |
/NoRpFix | 禁用重新分析点标记修复。 重新分析点是一个文件,它包含指向文件系统中其他文件的链接。 如果未指定 /NoRpFix,将不捕获解析为 /ImageFile 所指定值范围外的路径的重分析点。 |
/SWMFile | 用于引用拆分的 .wim 文件 (SWM)。 Pattern 是拆分文件的命名模式和位置。 指定命名模式时,请使用通配符。 例如,“E:\image\install*.swm”将应用 E:\image 目录中所有名为 install1.swm、install2.swm 等的拆分文件。 |
/ConfirmTrustedFile | 验证受信任桌面的映像。 此选项只能在至少运行 WinPE 4.0 的计算机上运行。 将 /Apply-Image 与 WinPE 中的 /ConfirmTrustedFile 选项结合使用时,请始终指定指向物理媒体位置的 /ScratchDir 选项。 这可以确保短文件名始终可用。 有关 /ScratchDir 选项的默认行为的详细信息,请参阅 DISM 命令行语法的全局选项。 从 Windows 10 版本 1607 开始,可以使用 /EA 来应用扩展属性。 |
/WIMBoot | 使用 /WIMBoot 可以追加采用 Windows 映像文件启动 (WIMBoot) 配置的映像。 此参数仅适用于已作为 WIMBoot 文件捕获或导出的 Windows 8.1 映像。 Windows 10 及更高版本不支持此功能。 |
/Compact | 在紧凑模式下应用映像,以节省驱动器空间。 取代了 WIMBoot。 仅适用于 Windows 10 桌面版(家庭版、专业版、企业版和教育版)。 注意: 如果使用 /ScratchDir 选项在紧凑模式下应用映像,请确保 ScratchDir 文件夹不在 FAT32 格式的分区中。 使用 FAT32 分区可能会导致 OOBE 期间发生意外的重新启动。 |
/EA | Windows 10 版本 1607 中的新增功能。 应用扩展属性。 |
/ApplyDrive | 使用 DeviceID 指定逻辑驱动器。 若要从命令行获取设备 ID,请键入“wmic diskdrive list brief”。 注意:VHD 在说明中可能会以名称“PhysicalDrive”显示,例如 \PhysicalDrive2。 |
/SFUFile | 使用 /SFUFile 可引用拆分 FFU 文件 (SFU)。 Pattern 是拆分文件的命名模式和位置。 |
示例:
Dism /apply-image /imagefile:install.wim /index:1 /ApplyDir:D:\
Dism /apply-image /imagefile:install.swm /swmfile:install*.swm /index:1 /applydir:D:
/Capture-CustomImage
将基于特定 install.wim 文件的增量文件更改捕获到 WIMBoot 映像的新文件 custom.wim 中。 不能捕获空目录。 捕获的文件将转换为指针文件。 custom.wim 放在 install.wim 旁边的同一个文件夹中。
重要须知
- /Capture-CustomImage 仅捕获自定义项文件。 不能使用它将安装文件捕获到新的 WIM 中。
- 请将 install.wim 和 custom.wim 文件放在一起。 请不要移出 install.wim 文件或 custom.wim 文件。
- 只能捕获自定义映像一次。 捕获增量文件更改后,请不要删除或重新捕获 custom.wim。
语法:
Dism /Capture-CustomImage /CaptureDir:<source_directory> [/ConfigFile:<configuration_file.ini>] [/CheckIntegrity] [/Verify] [/ConfirmTrustedFile]
参数 | 说明 |
---|---|
/CaptureDir | 指定要在其中应用和自定义映像的目录。 |
/ConfigFile | 指定用于列出映像捕获和压缩命令排除项的配置文件的位置。 有关详细信息,请参阅 DISM 配置列表和 WimScript.ini 文件。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Verify | 检查有无错误和文件重复。 |
[/ConfirmTrustedFile | 验证 Windows 10、Windows 8.1 或 Windows 8 上受信任桌面的映像。 此选项只能在至少运行 WinPE 4.0 的计算机上运行。 |
例如:
Dism /Capture-CustomImage /CaptureDir:D:\
/Capture-FFU
将物理驱动器分区的映像捕获到新的 .ffu 文件。
可将映像作为完整闪存实用工具映像 (.ffu) 文件或一组 FFU (.sfu) 拆分文件进行捕获;
语法:
Dism /Capture-Ffu /ImageFile:<path_to_image_file> /CaptureDrive:<physical_drive_path> /Name:<image_name> [/Description:<image_description>] [/PlatformIds:<platform_ids>] [/Compress:{default|none}]
参数 | 说明 |
---|---|
/CaptureDrive | 要捕获的物理驱动器。 可以使用 diskpart 获取驱动器号信息。 请使用 \\.\PhysicalDriveX 格式,其中,X 是 diskpart 提供的磁盘号。 |
/PlatformIds | 桌面捕获不需要此参数。 指定要添加到映像中的一个或多个平台 ID(以分号分隔)。 如果未指定,则平台 ID 将是“*”。 |
/Compress | 指定捕获时使用的压缩类型。 如果要拆分 FFU,请指定 none ,因为 DISM 不支持拆分压缩的 FFU。 |
示例:
捕获桌面 FFU:
DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0
捕获要拆分的桌面 FFU:
DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0 /Compress:none
/Capture-Image
将驱动器的映像捕获到新的 .wim 文件。 捕获的目录包括所有子文件夹和数据。 不能捕获空目录。 目录必须至少包含一个文件。 DISM 还可以选择性地应用和捕获扩展属性 (EA)。
可将映像作为 Windows 映像 (.wim) 文件或一组拆分的 Windows 映像 (.swm) 文件进行捕获;但此选项不支持捕获虚拟硬盘 (.vhd/.vhdx) 文件。 如果希望捕获 FFU,请参阅 /Capture-FFU
。
语法:
Dism /Capture-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>]
[/ConfigFile:<configuration_file.ini>] {[/Compress:{max|fast|none}] [/Bootable] | [/WIMBoot]} [/CheckIntegrity] [/Verify] [/NoRpFix] [/EA]
参数 | 说明 |
---|---|
/ConfigFile | 指定用于列出映像捕获和压缩命令排除项的配置文件的位置。 有关详细信息,请参阅 DISM 配置列表和 WimScript.ini 文件。 |
/Compress | 指定用于初始捕获操作的压缩类型。 maximum 选项提供最佳压缩效果,但需要更多的时间来捕获映像。 fast 选项提供更快的映像压缩,但生成的文件比使用 maximum 选项压缩的文件要大。 这也是在未指定参数时所用的默认压缩类型。 none 选项根本不压缩捕获的映像。 |
/Bootable | 将卷映像标记为可启动映像。 此参数仅适用于 WinPE 映像。 在 .wim 文件中,只能将一个卷映像标记为可启动。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Verify | 检查有无错误和文件重复。 |
/NoRpFix | 禁用重新分析点标记修复。 重新分析点是一个文件,它包含指向文件系统中其他文件的链接。 如果未指定 /NoRpFix,将不捕获解析为 /ImageFile 所指定值范围外的路径的重分析点。 |
/WIMBoot | 使用 /WIMBoot 可以追加采用 Windows 映像文件启动 (WIMBoot) 配置的映像。 此参数仅适用于已作为 WIMBoot 文件捕获或导出的 Windows 8.1 映像。 Windows 10 及更高版本不支持此功能。 |
/EA | 捕获扩展属性。 必须显式指定该开关才能捕获扩展特性。 如果已在组件中将扩展属性位设置为捕获到 WIM 映像中,则 DISM 会捕获这些位。 如果未设置这些位,则 DISM 不会设置它们。 只有 CAB 包和驱动程序的内置组件包含这些扩展属性位,AppX 包组件或 Win32 应用程序组件不包含这些位。 将跳过名称中带有前缀“$Kernel.”的扩展属性, 因为只捕获用户模式扩展属性。 如果在 Windows 10 版本 1607 中使用 DISM 来捕获扩展属性,并使用早期版本的 DISM 来应用映像,则操作将会成功,但扩展属性不会设置到应用的映像。 |
示例:
Dism /Capture-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D
dism /Capture-Image /CaptureDir:C:\ /ImageFile:"C:\WindowsWithOffice.wim" /Name:"Chinese Traditional" /ea
/Cleanup-Mountpoints
删除与损坏的已装载映像关联的所有资源。 此命令不会卸载已装载的映像,也不会删除可以使用 /Remount-Image 命令恢复的映像。
例如:
Dism /Cleanup-Mountpoints
有关详细信息,请参阅修复 Windows 映像
/Commit-Image
应用对已装载的映像所做的更改。 在使用 /Unmount-Image 选项之前,该映像将保持已装载状态。
语法:
Dism /Commit-Image /MountDir:<path_to_mount_directory> [/CheckIntegrity] [/Append]
参数 | 说明 |
---|---|
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Append | 将修改的映像添加到现有的 .wim 文件,而不是覆盖原始映像。 /CheckIntegrity 和 /Append 参数不适用于虚拟硬盘 (VHD) 文件。 |
例如:
Dism /Commit-Image /MountDir:C:\test\offline
/Delete-Image
从包含多个卷映像的 .wim 文件中删除指定的卷映像。 此选项仅删除元数据条目和 XML 条目。 它不会删除流数据,也不会优化 .wim 文件。
此命令行选项不适用于虚拟硬盘 (VHD) 文件。
语法:
Dism /Delete-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} [/CheckIntegrity]
参数 | 说明 |
---|---|
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
例如:
Dism /Delete-Image /ImageFile:install.wim /Index:1
/Export-Image
将指定映像的副本导出到另一个文件。 源文件和目标文件必须使用相同的压缩类型。 也可以通过将映像导出到新的映像文件,来优化该映像。 如果修改映像,DISM 将存储额外的资源文件,这会增大映像的总体大小。 导出映像会删除不必要的资源文件。
此命令行选项不适用于虚拟硬盘 (VHD) 文件。
语法:
Dism /Export-Image /SourceImageFile:<path_to_image_file> {/SourceIndex:<image_index> | /SourceName:<image_name>} /DestinationImageFile:<path_to_image_file> [/DestinationName:<Name>] [/Compress:{fast|max|none|recovery}] [/Bootable] [/WIMBoot] [/CheckIntegrity]
参数 | 说明 |
---|---|
/SWMFile | 用于引用拆分的 .wim 文件。 pattern 是拆分文件的命名模式和位置。 还可以指定通配符。 例如,“E:\image\install*.swm”将导出 E:\image 目录中所有名为 install1.swm、install2.swm 等的拆分文件。 |
/Compress | 指定用于初始捕获操作的压缩类型。 将映像导出到现有 .wim 文件时,/Compress 参数不适用;只有在将映像导出到新的 .wim 文件时,才能使用此参数。 maximum 选项提供最佳压缩效果,但需要更多的时间来捕获映像。 fast 选项提供更快的映像压缩,但生成的文件比使用 maximum 选项压缩的文件要大。 这也是在未指定参数时所用的默认压缩类型。 使用 recovery 选项可导出一键重置映像。 生成的文件要小得多,因而可以大大减少在恢复驱动器上保存一键重置映像所需的磁盘空间量。 必须使用 .esd 扩展名指定目标文件。 none 选项根本不压缩捕获的映像。 |
/Bootable | 将卷映像标记为可启动映像。 此参数仅适用于 WinPE 映像。 在 .wim 文件中,只能将一个卷映像标记为可启动。 |
/WIMBoot | 使用 /WIMBoot 可以追加采用 Windows 映像文件启动 (WIMBoot) 配置的映像。 此参数仅适用于已作为 WIMBoot 文件捕获或导出的 Windows 8.1 映像。 Windows 10 及更高版本不支持此功能。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
例如:
Dism /Export-Image /SourceImageFile:install.wim /SourceIndex:1 /DestinationImageFile:install2.wim
/Get-ImageInfo
显示有关 .wim、.ffu、.vhd 或 .vhdx 文件中包含的映像的信息。 与 /Index 或 /Name 参数结合使用时,将显示有关指定映像的信息,其中包括,该映像是否为 WIMBoot 映像、该映像是否为 Windows 8.1,具体请参阅使用 DISM 盘点映像或组件。 /Name 参数不适用于 VHD 文件。 必须对 FFU 和 VHDX 文件指定 /Index:1。
语法:
Dism /Get-ImageInfo /ImageFile:<path_to_image.wim> [{/Index:<Image_index> | /Name:<Image_name>}]
示例:
Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim
Dism /Get-ImageInfo /ImageFile:C:\test\images\myimage.vhd /Index:1
/Get-MountedImageInfo
返回当前装载的 .ffu、.vhd、.vhdx 和 .wim 映像列表,以及有关已装载的映像的信息,例如,该映像是否有效、读/写权限、装载位置、已装载文件的路径,以及已装载映像的索引。
例如:
Dism /Get-MountedImageInfo
/Get-WIMBootEntry
使用 /Get-WIMBootEntry 可以显示指定磁盘卷的 WIMBoot 配置条目。
有关如何显示 WIMBoot 配置条目的详细信息,请参阅“使用 DISM 盘点映像或组件”。
此参数仅适用于 Windows 8.1;Windows 10 及更高版本不支持此功能。
语法:
Dism /Get-WIMBootEntry /Path:<volume_path>
例如:
Dism /Get-WIMBootEntry /Path:C:\
/List-Image
显示指定映像中的文件和文件夹列表。
此命令行选项不适用于虚拟硬盘 (VHD) 文件。
语法:
Dism /List-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>}
例如:
Dism /List-Image /ImageFile:install.wim /Index:1
/Mount-Image
将 .ffu、.wim、.vhd 或 .vhdx 文件中的映像装载到指定的目录,使其可用于服务。
装载映像时,请注意以下几点:
- 必须创建装载目录,但该目录必须是空的。
- 所有映像类型都需要索引或名称值。 WIM 可以包含多个映像。 对于 FFU 和 VHD,请使用
index:1
。
语法:
Dism /Mount-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} /MountDir:<path_to_mount_directory> [/ReadOnly] [/Optimize] [/CheckIntegrity]
参数 | 说明 |
---|---|
/ReadOnly | 为装载的映像设置只读权限。 可选。 |
/Optimize | 缩短初始装载时间。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
示例:
Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
Dism /Mount-Image /ImageFile:C:\test\images\myimage.vhd /index:1 /MountDir:C:\test\offline /ReadOnly
Dism /Mount-Image /ImageFile:C:\test\images\WinOEM.ffu /MountDir:C:\test\offline /index:1
/Optimize-FFU
优化 FFU 映像,使其更快部署,还可更轻松地部署到大小不同的磁盘上。 有关详细信息,请参阅捕获和应用 Windows 完整闪存更新映像。
语法:
Dism /Optimize-FFU /ImageFile:<path-to-ffu-file> [/PartitionNumber:<PartitionNumber>]
参数 | 说明 |
---|---|
/ImageFile | 你想要优化的 FFU 的路径。 |
/PartitionNumber | 可选。 默认情况下,/Optimize-FFU 会优化 OS 分区。 通过 /PartitionNumber 可指定想要优化的分区。 |
示例:
Dism /Optimize-FFU /ImageFile:flash.ffu
Dism /Optimize-FFU /ImageFile:flash.ffu /PartitionNumber:2
/Optimize-Image
此命令应是在将映像应用于设备之前针对映像运行的最后一个命令,并且可在为存货生产方案构建设备时减少在工厂车间的时间。
语法:
DISM.exe /Image:C:\test\offline /Optimize-Image {/Boot | /WimBoot}
/Boot
尝试减少 OS 在启动期间花费的在线配置时间。 如果在优化后对映像执行任何服务操作,则此优化可能会失效。DISM /Optimize-Image /boot
可在下列操作系统中运行:Windows 11
Windows 10 版本 1607
Windows 10 版本 1809 及更高版本
Windows Server 2012 R2 及更高版本
使用
/Boot
尝试减少 OS 在启动期间花费的在线配置时间。 请注意,如果在优化后对映像执行任何服务操作,则此优化可能会失效。
/WimBoot
用于配置在 WIMBoot 系统上安装的脱机映像。
示例:
DISM.exe /Image:C:\test\offline /Optimize-Image /Boot
DISM.exe /Image:C:\test\offline /Optimize-Image /WimBoot
/Remount-Image
重新装载不可访问的已装载映像,并使其可用于服务。
语法:
Dism /Remount-Image /MountDir:<path_to_mount_directory>
例如:
Dism /Remount-Image /MountDir:C:\test\offline
/Split-FFU
对于 FFU,此命令会将现有的完整闪存更新 (.ffu) 文件拆分为多个只读的 .sfu 拆分文件。 DISM 不支持拆分压缩的 FFU。 如果要拆分 FFU,请确保 FFU 是在指定了 /compress:none
选项的情况下捕获的。
此选项将在指定的目录中创建 .sfu 文件,并根据相同的 /SFUFile 指定值将每个文件命名,但在名称中追加一个编号。 例如,如果使用 c:\flash.sfu
,则会获得类似于 flash.sfu、flash2.ffu、flash3.sfu 的文件。此选项会定义 .sfu 拆分文件的每个部分,并将其保存到 C:\ 目录。
FFU 的语法:
Dism /Split-Ffu /ImageFile:<path_to_image_file> /SFUFile:<pattern> /FileSize:<MB-Size> [/CheckIntegrity]
参数 | 说明 |
---|---|
/FileSize | 指定每个已创建文件的最大大小 (MB)。 如果单个文件大于 /FileSize 选项中指定的值,则生成的 .swm 拆分文件之一将大于 /FileSize 选项中指定的值,以容纳大文件。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/ImageFile | 指定某个 .FFU 文件(例如 flash.ffu)的路径。 |
/SFUFile | 引用拆分的 FFU 文件 (SFU)。 Pattern 是拆分文件的命名模式和位置。 |
例如:
DISM.exe /Split-Ffu /ImageFile:flash.ffu /SFUFile:flash.sfu /FileSize:650
/Split-Image
对于 WIM,此命令会将现有的 .wim 文件拆分为多个只读的 .swm 拆分文件。
此选项将在指定的目录中创建 .swm 文件,并根据相同的 path_to_swm 指定值将每个文件命名,但在名称中追加一个编号。 例如,如果将 path_to_swm 设置为 c:\Data.swm
,则此选项将创建类似于 Data.swm、Data2.swm、Data3.swm 的文件,定义 .wim 拆分文件的每个部分,并将其保存到 C:\ 目录。
此命令行选项不适用于虚拟硬盘 (VHD) 文件。
WIM 的语法:
Dism /Split-Image /ImageFile:<path_to_image_file> /SWMFile:<path_to_swm> /FileSize:<MB-Size> [/CheckIntegrity]
参数 | 说明 |
---|---|
/FileSize | 指定每个已创建文件的最大大小 (MB)。 如果单个文件大于 /FileSize 选项中指定的值,则生成的 .swm 拆分文件之一将大于 /FileSize 选项中指定的值,以容纳大文件。 |
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/ImageFile | 指定某个映像文件(例如 install.wim)的路径。 |
例如:
Dism /Split-Image /ImageFile:install.wim /SWMFile:split.swm /FileSize:650
/Unmount-Image
卸载 .ffu、.wim、.vhd 或 .vhdx 文件,并提交或丢弃装载映像时所做的更改。
使用 /Unmount-Image 选项时,必须使用 /commit 或 /discard 参数。
语法:
Dism /Unmount-Image /MountDir:<path_to_mount_directory> {/Commit | /Discard} [/CheckIntegrity] [/Append]
参数 | 说明 |
---|---|
/CheckIntegrity | 与 capture、unmount、export 和 commit 操作结合使用时,可检测和跟踪 .wim 文件损坏情况。 将 /CheckIntegrity 与 apply 和 mount 操作结合使用时,如果 DISM 检测到 .wim 文件已损坏,则此参数将停止操作。 |
/Append | 将修改的映像添加到现有的 .wim 文件,而不是覆盖原始映像。 /CheckIntegrity 和 /Append 参数不适用于虚拟硬盘(VHD、VHDX)或 FFU 文件。 |
示例:
Dism /Unmount-Image /MountDir:C:\test\offline /commit
Dism /Unmount-Image /MountDir:C:\test\offline /discard
/Update-WIMBootEntry
使用已重命名的映像文件或已移动的映像文件路径,来更新与指定的数据源 ID 关联的 WIMBoot 配置条目。
注意:/Update-WIMBootEntry 要求重启,这样才能使任何更新生效。
语法:
Dism /Update-WIMBootEntry /Path:<Volume_path> /DataSourceID:<Data_source_id> /ImageFile:<Renamed_image_path>
参数 | 说明 |
---|---|
/Path | 指定 WIMBoot 配置的磁盘卷。 |
/DataSourceID | 指定 /Get-WIMBootEntry 显示的数据源 ID。 |
例如:
DISM.exe /Update-WIMBootEntry /Path:C:\ /DataSourceID:0 /ImageFile:R:\Install.wim
/Apply-SiloedPackage
将一个或多个孤立的预配包 (SPP) 应用到指定的映像。 仅当从 ADK 1607 或更高版本运行 CopyDandI.cmd,并从 CopyDandI.cmd 创建的目标文件夹运行 dism.exe /Apply-SiloedPackage
之后,此选项才可用。
注意
/Apply-SiloedPackage
只能针对 Windows 映像运行一次,但 /PackagePath 可在同一命令中使用多次来应用多个 SPP。 SPP 将按指定的顺序应用,因此应先指定依赖项,然后再指定依赖于它的 SPP。
有关孤立的预配包的详细信息以及如何使用 CopyDandI.cmd,请参阅孤立的预配包。
若要了解如何使用孤立的预配包,请参阅实验 10:使用孤立的预配包 (SPP) 添加桌面应用程序和设置。
/Apply-SiloedPackage /PackagePath:<package_path> /ImagePath:<applied_image_path>
参数 | 说明 |
---|---|
/PackagePath | 指定孤立的预配包文件的路径。 |
/ImagePath | 指定要在其中应用 SPP 的 Windows 映像的路径。 |
例如:
Dism.exe /apply-SiloedPackage /PackagePath:C:\test\Word.spp /PackagePath:C:\test\spp2.spp /ImagePath:C:\