2024年2月21日发(作者：)

 部署映像服务和管理工具

版本: 10.0.10240.16384

[dism_options] {Imaging_command} []

{/Image: | /Online} [dism_options]

{servicing_command} []

描述:

DISM 枚举、安装、卸载、配置和更新 Windows 映像中的功能和程序包。可以使用的命令取决于提供的映像以及映像是处于脱机还是运行状态。

通用映像处理命令:

/Split-Image - 将现有 .wim或 .ffu文件拆分为多个只读拆分 WIM/FFU 文件。

/Apply-Image - 应用一个映像。

/Get-MountedImageInfo - 显示有关安装的 WIM 和 VHD 映像的信息。

/Get-ImageInfo - 显示有关 WIM 或 VHD 文件中映像的信息。

/Commit-Image - 保存对装载的 WIM 或 VHD 映像的更改。

/Unmount-Image - 卸载已装载的 WIM 或 VHD 映像。

/Mount-Image - 从 WIM 或 VHD 文件装载映像。

/Remount-Image - 恢复孤立的映像装载目录。

/Cleanup-Mountpoints - 删除与损坏的已安装映像关联的资源。

WIM 命令:

/Apply-CustomDataImage - 冻结自定义数据映像中包含的文件。

/Capture-CustomImage - 将自定义设置捕获到WIMBoot系统上的增量 WIM 文件中。

捕获的目录包括所有子文件夹和数据。

/Get-WIMBootEntry - 显示指定磁盘卷的WIMBoot配置项。

/Update-WIMBootEntry - 更新指定磁盘卷的WIMBoot配置项。

/List-Image - 显示指定映像中的文件和文件夹的列表。

/Delete-Image - 从具有多个卷映像的 WIM 文件删除指定的卷映像。

/Export-Image - 将指定映像的副本导出到其他文件。

/Append-Image - 将其他映像添加到 WIM 文件中。

/Capture-Image - 将驱动器的映像捕获到新的 WIM 文件中。捕获的目录包含所有子文件夹和数据。

/Get-MountedWimInfo - 显示有关安装的 WIM 映像的信息。

/Get-WimInfo - 显示有关 WIM 文件中的映像的信息。

/Commit-Wim - 保存对安装的 WIM 映像的更改。

/Unmount-Wim - 卸载安装的 WIM 映像。

/Mount-Wim - 从 WIM 文件安装映像。

/Remount-Wim - 恢复孤立的 WIM 安装目录。

/Cleanup-Wim - 删除与损坏的已安装 WIM映像关联的资源。

映像规格:

/Online - 以正在运行的操作系统为目标。

/Image - 指定脱机 Windows 映像的根目录的路径。

DISM 选项:

/English - 用英文显示命令行输出。

/Format - 指定报告输出格式。

/WinDir - 指定 Windows 目录的路径。

/SysDriveDir - 指定名为BootMgr的系统加载程序文件的路径。

/LogPath - 指定日志文件路径。

/LogLevel - 指定日志(1-4)中所示的输出级别。

/NoRestart - 取消自动重新启动和重新启动提示。

/Quiet - 取消除错误消息之外的所有输出。

/ScratchDir - 指定暂存目录的路径。

若要获得有关这些 DISM 选项及其参数的详细信息，请在紧挨着 /? 之前指定一个选项。

示例:

/Mount-Wim /?

/ScratchDir /?

/Image:C:testoffline /?

/Online /?

 部署映像服务和管理工具

/Split-Image

/ImageFile: /SWMFile: /FileSize: [/CheckIntegrity]

/ImageFile: /SFUFile: /FileSize: [/CheckIntegrity]

将现有 .wim或 .ffu文件拆分为多个只读拆分 WIM 或 FFU 文件。

使用 /FileSize可为创建的每个文件以兆字节(MB)为单位指定最大大小。

使用 /CheckIntegrity可检测和跟踪 WIM 文件损坏。

示例:

/Split-Image /ImageFile: /SWMFile: /FileSize:650

/Split-Image /ImageFile: /SFUFile: /FileSize:650

 部署映像服务和管理工具

/Apply-Image /ImageFile: /ApplyDir:

{/Index: | /Name:} [/CheckIntegrity] [/Verify]

[/NoRpFix] [/SWMFile:] [/ConfirmTrustedFile] [/WIMBoot] [/Compact]

/Apply-Image /ImageFile: /ApplyDrive:

[/SFUFile:] [/SkipPlatformCheck]

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

使用 /CheckIntegrity可在检测到 WIM 文件损坏时停止操作。

使用 /Verify 可查找错误和文件重复。

使用 /NoRpFix可禁用重分析点标记修复。

使用 /SWMFile可引用拆分的 WIM 文件(SWM)。是拆分文件的命名模式和位置。

使用 /ConfirmTrustedFile可验证受信任桌面的映像。请参阅

/fwlink/?LinkID=309482 来了解有关受支持平台的详细信息。

使用 /WIMBoot可使用WIMBoot配置应用映像。

使用 /Compact 可以压缩模式应用映像。

使用 /SFUFile可引用拆分的 FFU 文件(SFU)。是拆分文件的命名模式和位置。

如果要应用的 FFU 文件的目标位置是

执行应用程序的计算机以外的设备，请使用 /SkipPlatformCheck。特殊 FFU 文件是必需的。

示例:

/Apply-Image /ImageFile: /Index:1 /ApplyDir:D:

/Apply-Image /ImageFile: /SWMFile:install*.swm /ApplyDir:D: /Index:1

/Apply-Image /ImageFile: /ApplyDrive:.PhysicalDrive0

 部署映像服务和管理工具

/Get-MountedImageInfo

显示有关装载的映像的信息，包括映像是否可用于提供服务、是否需要重新装载或者是否为无效映像。

示例:

/Get-MountedImageInfo

 部署映像服务和管理工具

/Get-ImageInfo /ImageFile: [/Index: | /Name:]

显示有关指定的 WIM 或 VHD 文件中包含的映像的信息。

示例:

/Get-ImageInfo /ImageFile:C:

/Get-ImageInfo /ImageFile:C: /Index:1

 部署映像服务和管理工具

/Commit-Image /MountDir: [/Append] [/CheckIntegrity]

将更改应用于装载的映像。在使用 /Unmount-Image 选项之前，映像一直保持装载。

使用 /Append 将映像添加到现有 .wim文件。

使用 /CheckIntegrity检测和跟踪 WIM 文件损坏。

示例:

/Commit-Image /MountDir:C:testoffline

 部署映像服务和管理工具

/Mount-Image /ImageFile: {/Index: | /Name:}

/MountDir: [/ReadOnly] [/Optimize] [/CheckIntegrity]

将映像安装到指定的目录，以便可用于提供服务。

使用 /Optimize 可在安装映像时缩短初始安装时间。

使用 /CheckIntegrity可在检测到 WIM 文件损坏时停止操作。

使用 /ReadOnly将安装的映像设置为只读权限。

示例:

/Mount-Image /ImageFile:C: /Index:1 /MountDir:C:testoffline

/Mount-Image /ImageFile:C: /Index:1 /MountDir:C:testoffline /ReadOnly

 部署映像服务和管理工具

/Remount-Image /MountDir:

恢复孤立的映像安装目录。

示例:

/Remount-Image /MountDir:C:testoffline

 部署映像服务和管理工具

/Cleanup-Mountpoints

删除与损坏的已安装映像关联的资源。此命令不会卸载已安装的映像，也不会删除可使用 /Remount-Image 命令恢复的映像。

示例:

/Cleanup-Mountpoints

 部署映像服务和管理工具

/Apply-CustomDataImage /SingleInstance /CustomDataImage: /ImagePath:

冻结自定义数据映像中包含的文件以节省空间。

示例:

/Apply-CustomDataImage /CustomDataImage:C: /ImagePath:C: /SingleInstance

 部署映像服务和管理工具

/Capture-CustomImage /CaptureDir: [/ConfigFile:<>] [/CheckIntegrity] [/Verify]

[/ConfirmTrustedFile]

将映像自定义设置捕获到WIMBoot系统上的新 WIM 文件中。捕获的目录包括所有子文件夹和数据。无法捕获空目录。注意: 此命令仅捕获自定义设置文件。它不能用于将安装文件捕获到新WIM 文件中。

使用 /ConfigFile可指定列出了映像捕获和压缩命令的排除项的配置文件所在的位置。

使用 /CheckIntegrity可检测和跟踪 WIM 文件损坏。

使用 /Verify 可检查错误和文件重复。

使用 /ConfirmTrustedFile可验证“受信任桌面”的映像。有关支持的平台的详细信息，请参阅

示例:

/Capture-CustomImage /CaptureDir:D:

 部署映像服务和管理工具

/Get-WIMBootEntry /Path:

显示指定磁盘卷的WIMBoot配置项。

示例:

/Get-WIMBootEntry /Path:C:

 部署映像服务和管理工具

/Update-WIMBootEntry /Path: /DataSourceID: /ImageFile:

更新WIMBoot配置项(与指定的数据源 ID 关联，与重命名的或移动的映像文件路径关联)。

使用 /Path 可指定WIMBoot配置的磁盘卷。

使用 /DataSourceID可指定 Get-WIMBootEntry显示的数据源 ID。

示例:

/Update-WIMBootEntry /Path:C: /DataSourceID:0 /ImageFile:R:

 部署映像服务和管理工具

/List-Image /ImageFile: {/Index: | /Name:}

显示指定映像中的文件和文件夹的列表。

示例:

/List-Image /ImageFile: /Index:1

 部署映像服务和管理工具

/Delete-Image /ImageFile: {/Index: | /Name:} [/CheckIntegrity]

从具有多个卷映像的 WIM 文件中删除指定的卷映像。

使用 /CheckIntegrity检测和跟踪 WIM 文件损坏。

示例:

/Delete-Image /ImageFile: /Index:1

 部署映像服务和管理工具

/Export-Image {/SourceImageFile: | [/SWMFile:]}

{/SourceIndex: | /SourceName:}

/DestinationImageFile: [/DestinationName:]

{[/Compress:{fast|max|none|recovery}] [/Bootable] | [/WIMBoot]}

[/CheckIntegrity]

将指定映像的副本导出到其他文件。源文件和目标文件必须使用同一种压缩类型。

使用 /SWMFile可引用拆分的 WIM 文件(SWM)。是拆分文件的命名模式和位置。

使用 /Compress 可指定在将映像导出到新 WIM 文件时用于捕获操作的压缩类型。

使用 /Bootable 可将 Windows PE 卷映像标记为能够引导。

使用 /WIMBoot可导出能够使用WIMBoot配置应用的映像。

使用 /CheckIntegrity可检测和跟踪 WIM 文件损坏。

示例:

/Export-Image /SourceImageFile: /SourceIndex:1

/DestinationImageFile:

 部署映像服务和管理工具

/Append-Image /ImageFile: /CaptureDir: /Name:

[/Description:Description] [/ConfigFile:<>] {[/Bootable] | [/WIMBoot]} [/CheckIntegrity] [/Verify]

[/NoRpFix]

将其他映像添加到 WIM 文件中。

使用 /ConfigFile可指定列出了映像捕获和压缩命令的排除项的配置文件所在的位置。

使用 /Bootable 可将 Windows PE 卷映像标记为能够引导。

使用 /WIMBoot可将配置了WIMBoot的映像追加到 WIM 文件。

使用 /CheckIntegrity可检测和跟踪 WIM 文件损坏。

使用 /Verify 可检查错误和文件重复。

使用 /NoRpFix可禁用重分析点标记修复。

示例:

/Append-Image /ImageFile: /CaptureDir:D: /Name:Drive-D

 部署映像服务和管理工具

/Capture-Image /ImageFile: /CaptureDir:/Name:

[/Description:Description] [/ConfigFile:<>]

{[/Compress:{fast|max|none}] [/Bootable] | [/WIMBoot]} [/CheckIntegrity] [/Verify] [/NoRpFix]

将驱动器的映像捕获到新的 WIM 文件中。捕获的目录包括所有子文件夹和数据。无法捕获空目录。

使用 /ConfigFile可指定列出了映像捕获和压缩命令的排除项的配置文件所在的位置。

使用 /Compress 可指定用于执行初始捕获操作的压缩类型。

使用 /Bootable 可将 Windows PE 卷映像标记为能够引导。

使用 /WIMBoot可捕获能够使用WIMBoot配置应用的映像。

使用 /CheckIntegrity可检测和跟踪 WIM 文件是否损坏。

使用 /Verify 可检查错误和文件重复。

使用 /NoRpFix可禁用重分析点标记修复。

示例:

/Capture-Image /ImageFile: /CaptureDir:D: /Name:Drive-D

 部署映像服务和管理工具

/Get-MountedWimInfo

显示有关装载的映像的信息，包括映像是否可用于提供服务、是否需要重新装载或者是否为无效映像。

示例:

/Get-MountedWimInfo

 部署映像服务和管理工具

/Get-WimInfo /WimFile: [/Index: | /Name:]

显示有关指定的 WIM 文件中包含的映像的信息。

示例:

/Get-WimInfo /WimFile:C:

/Get-WimInfo /WimFile:C: /Index:1

 部署映像服务和管理工具

/Commit-Wim /MountDir:

应用对装载的映像所做的更改。在使用 /Unmount-Wim选项之前，映像一直保持装载。

示例:

/Commit-Wim /MountDir:C:testoffline

 部署映像服务和管理工具

/Mount-Wim /WimFile: {/Index: | /Name:}

/MountDir: [/readonly]

将 WIM 文件安装到指定的目录，以便该文件可用于提供服务。

可以使用 /ReadOnly将安装的映像设置为具有只读权限。

示例:

/Mount-Wim /WimFile:C: /index:1 /MountDir:C:testoffline

/Mount-Wim /WimFile:C: /index:1 /MountDir:C:testoffline /ReadOnly

 部署映像服务和管理工具

/Remount-Wim /MountDir:

恢复孤立的 WIM 安装目录。

示例:

/Remount-Wim /MountDir:C:testoffline

 部署映像服务和管理工具

/Cleanup-Wim

删除与损坏的已安装映像关联的资源。此命令不会卸载已安装的映像，也不会删除

可以使用 /Remount-WIM 命令恢复的映像。

示例:

/Cleanup-Wim

 部署映像服务和管理工具

/Image:

这是脱机 Windows 映像的根目录的路径。此选项必须与服务命令一起使用。

示例:

/Image:C:testoffline /Get-Packages