DISM 命令行语法的全局选项
全局选项用于部署映像维护和管理 (DISM) 中的大部分维护和映像选项。 这些选项可用于访问命令行帮助、指定文件位置和控制日志记录。
维护命令的基本语法
装载或应用 Windows 映像后，该映像可作为平面文件结构脱机使用，因此你可以指定 DISM 全局选项、映像的维护选项以及脱机映像的位置。 每个命令行只能使用一个维护选项。
若要维护正在运行的计算机，请使用 /Online 选项。 若要维护已装载或已应用的映像，请指定 /Image:<path_to_image>。 可用于维护映像的命令和选项取决于你所维护的 Windows 操作系统。 另外还取决于映像是脱机映像还是某个正在运行的操作系统。 所有命令都适用于脱机 Windows 映像。 命令的子集可用于维护正在运行的操作系统。
DISM 维护命令的基本语法为：
DISM.exe {/Image:<path_to_image> | /Online} [dism_global_options] {servicing_option} [<servicing_argument>]
有关维护命令的详细信息，请参阅部署映像维护和管理 (DISM) 命令行选项。
映像命令的基本语法
许多全局选项也可用于映像命令。 DISM 映像命令的基本语法为：
DISM.exe [dism_global_options] {servicing_option} [<servicing_argument>]
若要详细了解如何使用 DISM 进行映像管理（例如如何应用或装载映像），请参阅 DISM 映像管理命令行选项。
维护和映像命令的全局选项
脱机映像语法
以下 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>] [/English] [/Format:<output_format>]
联机映像语法
以下 DISM 全局选项可用于运行操作系统。
DISM.exe /online [/LogPath:<path_to_log_file>] [/LogLevel:<n>] [/SysDriveDir:<path_to_bootMgr_file>] [/Quiet] [/NoRestart] [/ScratchDir:<path_to_scratch_directory>] [/English] [/Format:<output_format>]
选项
下表提供了如何使用每个 DISM 全局选项的说明。 这些选项不区分大小写。
| 全局选项 | 说明 |
|---|---|
/Get-Help /? |
显示有关可用 DISM 命令行选项和参数的信息。 在不指定映像文件的情况下使用 /? 或 /Get-Help 选项获取有关映像管理命令（如 /Mount-Image）的帮助。 示例： Dism /? 使用 /Image:<path_to_an_image> 选项指定映像文件，或使用 /Online 选项获取有关映像中的维护命令（例如 /Get-Packages）的帮助。 可用于维护映像的选项取决于在映像中可用的维护技术。 示例： 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:<日志文件路径.log> |
指定日志文件所在的完整路径和文件名。 如果此项未设置，则默认值为 %WINDIR%\Logs\Dism\dism.log
重要说明
在 Windows PE 中，默认目录为 RAMDISK 暂存空间，最小可以为 32 MB。 日志文件将自动存档。 存档的日志文件将以文件名后附加 .bak 的形式保存，并且将生成新的日志文件。 每次存档日志文件时，都将覆盖该 .bak 文件。 当使用一个尚未加入域的网络共享时，请先结合使用 net use 命令和域凭据来设置访问权限，然后再设置 DISM 日志的日志路径。 示例： 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> |
在 Windows PE 环境中使用 /SysDriveDir 来维护安装的 Windows 映像。 /SysDriveDir 选项指定 BootMgr 文件位置的路径。 仅当 BootMgr 文件所在的分区不是运行命令所在的分区时，才必须这样做。 例如，在 Windows PE 命令提示符下键入： Dism /image:C:\Windows /SysDriveDir:C:</strong> |
/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<em>%Temp% 目录，其子目录名称为每次运行 DISM 时随机生成的十六进制值。 每次操作后，都会删除暂存目录中的项。 不应将网络共享位置用作暂存目录来展开安装包（.cab 或 .msu 文件）。 用于解压缩供服务过程临时使用的文件的目录应为本地目录。 示例： Dism /image:C:\test\offline /ScratchDir:C:\Scratch /Add-Package /PackagePath:C:\packages\package.cab |
/English |
以英语显示命令行输出。
注意
某些资源无法以英语显示。 使用 DISM /? 命令时，不支持此选项。 示例： Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim /index:1 /English |
/Format:{Table | List} |
指定报表输出格式。 示例： Dism /Image:C:\test\offline /Get-Apps /Format:table |