部署映像服务和管理命令行选项.doc

部署映像服务和管理命令行选项
发布时间: 2009年10月
更新时间: 2009年10月
应用到: Windows 7
部署映像服务和管理 (DISM.exe) 用于安装、卸载、配置和更新脱机 Windows(R) 映像和脱机 Windows 预安装环境 (Windows PE) 映像中的功能和程序包。可用于处理映像的命令和选项取决于您所处理的 Windows 操作系统（Windows® 7、Windows Vista® Service Pack 2 (SP2)、Windows Vista® Service Pack 1 (SP1)、Windows Server® 2008 R2、Windows Server® 2008 或 Windows PE），以及映像是脱机还是处于运行状态的操作系统。所有的命令都可用于处理脱机 Windows 映像。这些命令的子集可用于处理处于运行状态的操作系统。
DISM 命令行选项是全局选项，而且可与大多数服务命令行选项一同使用。服务命令行选项独立发挥作用，不能与其他服务命令行选项结合使用。通过装载 Windows 映像或指定处于运行状态的操作系统，可以处理该 Windows 映像。
DISM 取代了多个 Windows OEM 预安装工具包 (Windows OPK) 工具，包括 PEImg、Intlcfg 和程序包管理器。
DISM 命令行选项
若要处理脱机 Windows 映像，必须先装载该映像。可以使用 Windows 映像 (WIM) 命令和参数来装载 WIM 映像，以便进行处理和管理。还可以使用这些命令列出索引或验证正在装载的映像的体系结构。更新映像后，必须将其卸载并提交或放弃已做的更改。
以下命令可用于装载、卸载和查询 WIM 文件。这些选项不区分大小写。

选项
参数
描述
/Mount-Wim
/WimFile:<path_to_image.wim>
/Index:<image_index>
/Name:<image_name>
/MountDir:<path_to_mount_directory>
/ReadOnly
将 WIM 文件装载到指定的目录，以便可对其进行处理。
/ReadOnly 设置具有只读权限的已装载映像。可选。
备注
对于指定 WIM 文件的大多数操作，需要索引或名称值。
示例：

复制代码
Dism /Mount-Wim /WimFile:C:\test\images\install.wim /index:1 /MountDir:C:\test\offline /ReadOnly

复制代码
Dism /Mount-Wim /WimFile:C:\test\offline\install.wim /name:"Windows Vista HomeBasic" /MountDir:C:\test\offline
/Commit-Wim
/MountDir:<path_to_mount_directory>
应用对所装载映像已做的更改。在使用 /unmount 选项之前，映像一直保持装载状态。
示例：

复制代码
Dism /Commit-Wim /MountDir:C:\test\offline
/Unmount-Wim
/MountDir:<path_to_mount_directory>
{/Commit | /Discard}
卸载 WIM 文件并提交或放弃装载映像时所做的更改。
示例：

复制代码
Dism /Unmount-Wim /MountDir:C:\test\offline /commit

复制代码
Dism /Unmount-Wim /MountDir:C:\test\offline /discard
/Remount-Wim
/MountDir:<path_to_mount_directory>
重新装载已装载但不能访问的 WIM 文件并使其可供处理。
示例：

复制代码
Dism /Remount-Wim /MountDir:<path_to_mount_directory>
/Cleanup-Wim

删除与已放弃的装载 WIM 映像相关联的所有资源。此命令不会卸载当前装载的映像，也不会删除可能重新装载的映像。
示例：

复制代码
Dism /Cleanup-Wim
/Get-WimInfo
/WimFile:<path_to_image.wim>
/Index:<Image_index>
/Name:<Image_name>
显示有关 WIM 中的映像信息。与 /Index 或 /Name 选项一同使用时，将显示有关指定映像的信息。
示例：

复制代码
Dism /Get-WimInfo /WimFile:C:\test\offline\install.wim /index:1
/Get-MountedWimInfo

列出当前装载的映像以及有关已装载映像的信息（如读/写权限、装载位置、装载文件的路径，以及装载映像索引）。
示例：

复制代码
Dism /Get-MountedWimInfo
几乎所有 DISM 命令的基本语法都相同。装载或应用 Windows 映像使其可作为平面文件结构脱机使用后，可以指定任何 DISM 选项、将用于更新映像的服务命令，以及脱机映像的位置。只能在一个命令行中使用一个服务命令。如果您正在处理处于运行状态的计算机，则可以使用 /Online 选项，而不需要指定脱机 Windows 映像的位置。
DISM 的基本语法为：
DISM.exe {/Image:<path_to_image> | /Online} [dism_options] {servicing_command} [<servicing_argument>]
以下 DISM 选项可用于脱机映像。
DISM.exe /image:<path_to_offline_image_directory> [/WinDir:<path_to_%WINDIR%>] [/LogPath:<path_to_log_file.log>] [/LogLevel:<n>] [SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>]
以下 DISM 选项可用于处于运行状态的操作系统。
DISM.exe /online [/LogPath:<path_to_log_file>] [/LogLevel:<n>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>]
下表描述了如何使用每个 DISM 选项。这些选项不区分大小写。

选项
描述
/Get-Help
/?
显示有关可用 DISM 命令行选项和参数的信息。
可用于处理映像的选项取决于在映像中可用的处理技术。指定映像（脱机映像或处于运行状态的操作系统）时，随即会生成有关可用于正在处理的映像的特定选项的信息。
示例：

复制代码
Dism /?

复制代码
Dism /image:C:\test\offline /?

复制代码
Dism /online /?
通过指定命令行选项，可以显示其他帮助。
示例：

复制代码
Dism /image: C:\test\offline /Add-Driver /?

复制代码
Dism /image:C:\test\offline /Add-Package /?

复制代码
Dism /online /Get-Drivers /?
/LogPath:<path to log file.log>
指定要记录到的完整路径和文件名。如果未设置此选项，则默认值为：%WINDIR%\Logs\Dism\dism.log
重要事项
在 Windows PE 中，默认目录为 RAMDISK 暂存空间（最低可为 32 MB）。
日志文件将自动存档。存档的日志文件将以文件名后附加 .bak 的形式保存，并且将生成新的日志文件。每次存档日志文件时，都会覆盖 .bak 文件。
如果使用未加入域的网络共享，请在设置 DISM 日志的日志路径之前，使用带有域凭据的 net use 命令来设置访问权限。
示例：

复制代码
Dism /image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.cab
/LogLevel:<n>
指定日志中显示的最大输出级别。默认的日志级别为 3。接受的值为：
1 = 仅限于错误
2 = 错误和警告
3 = 错误、警告和信息
4 = 以上所有内容和调试输出
示例：

复制代码
Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/Image:<path_to_offline_image_directory>
这是将处理的脱机 Windows 映像的根目录的完整路径。如果名为 Windows 的目录不是根目录的子目录，则必须指定 /WinDir。
此选项不能与 /Online 一起使用。
示例：

复制代码
Dism /image:C:\test\offline /LogPath:AddPackage.log /LogLevel:1 /Add-Package /PackagePath:C:\packages\package.cab
/WinDir:<path_to_%WINDIR%>
与 /Image 选项一起使用，可以指定相对于映像路径的 Windows 目录路径。此路径不能为 Windows 目录的完整路径，而应为相对路径。如果未指定此选项，则默认值为脱机映像目录的根目录中的 Windows 目录。
此选项不能与 /Online 选项一起使用。
示例：

复制代码
Dism /image:C:\test\offline /WinDir:WinNT /Add-Package /PackagePath:C:\packages\package.cab
/Online
指定将对当前处于运行状态的操作系统执行该操作。
此选项不能与 /Image 或 /WinDir 选项一起使用。使用 /Online 时，联机映像的 Windows 目录会被自动删除。
示例：

复制代码
Dism /online /Get-Packages
/SysDriveDir:<path_to_sysdrive_directory>
指定 BootMgr 文件位置的路径。只有当 BootMgr 文件位于包含 Windows 目录的分区以外的其他分区时以及需要处理 BootMgr 文件时，此选项才是必要的。
如果处理的是已应用的映像，则此选项不是必要的，因为系统分区不是 WIM 文件的一部分。
示例：

复制代码
Dism /image:C:\test\offline /SysDriveDir:C:\
/Quiet
关闭到控制台的信息和进度输出。只显示错误消息。
若要在安静模式下运行，每次运行命令行实用程序时都必须设置此选项。此选项必须位于服务命令前面。
备注
请不要将 /Quiet 选项与 /Get 命令一起使用。不会显示任何信息。
示例：

复制代码
Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package.cab /quiet
/NoRestart
禁止重新启动。如果不需要重新引导，则此命令不执行任何操作。此选项使应用程序不提示重新启动（或在使用 /Quiet 选项时，使应用程序不会自动重新启动）。
示例：

复制代码
Dism /online /Add-Package /PackagePath:C:\packages\package.cab /NoRestart /quiet
/ScratchDir:<path_to_scratchdirectory>
指定在服务期间提取临时使用的文件时要使用的临时目录。该目录必须位于本地。如果未指定临时目录，将使用 \Windows\%Temp% 目录，以及每次运行 DISM 时随机生成的十六进制值的子目录名称。每次操作后，都会删除暂存目录中的项。
不应使用网络共享位置作为暂存目录来展开要安装的程序包（.cab 文件或 .msu 文件）。用于在服务期间提取临时使用文件的目录应为本地目录。
示例：

复制代码
Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab
/English
用英文显示命令行输出。
备注
某些资源无法用英文显示。
使用 DISM /? 命令时，不支持此选项。
示例：

复制代码
Dism /Get-WimInfo /WimFile:C:\test\offline\install.wim /index:1 /English
服务命令行选项
根据指定的映像（Windows 7、Windows Vista SP2、带 SP1 的 Windows Vista、Windows Server 2008 R2、Windows Server 2008 或 Windows PE）以及映像是脱机还是处于运行状态的操作系统，可以对服务命令和参数执行以下类型的更新：
备注
不能在同一命令行上使用两种不同类型的服务命令。
· 用于准备 Windows PE 映像的 Windows PE 特定服务命令。有关详细信息，请参阅 Windows PE 服务命令行选项。
· 用于添加、删除和枚举驱动程序 .inf 文件的驱动程序特定服务命令。有关详细信息，请参阅驱动程序服务命令行选项。
· 用于添加、删除和枚举程序包以及启用、禁用和枚举功能的程序包服务命令。有关详细信息，请参阅操作系统程序包服务命令行选项
· 用于调整国际设置和配置的国际服务命令。有关详细信息，请参阅语言和国际服务命令行选项。
· 用于更改 Windows 映像版本的版本服务命令。有关详细信息，请参阅 Windows 版本服务命令行选项。
· 可用于应用 Unattend.xml 文件的服务命令。有关详细信息，请参阅无人参与服务命令行选项。
· 可用于检查 Windows(R) Installer 应用程序修补程序（.msp 文件）的适用性以及查询脱机映像以获取有关已安装的 MSI 应用程序和应用程序修补程序（.msp 文件）信息的服务命令。有关详细信息，请参阅应用程序服务命令行选项。