2024年1月4日发(作者:)

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

版本: 6.1.7600.16385

[dism_options] {WIM_command} []

{ /Image: | /Online} [dism_options]{servicing_command}

[]

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

WIM 命令:

显示有关安装的 WIM 映像的信息。

/Get-MountedWimInfo

/Get-WimInfo

/Commit-Wim

/Unmount-Wim

/Mount-Wim

/Remount-Wim

/Cleanup-Wim

映像规格:

/Online

/Image

DISM 选项:

/English

/Format

/WinDir

/SysDriveDir

/LogPath

/LogLevel

/NoRestart

/Quiet

/ScratchDir

显示有关 WIM 文件中的映像的信息。

保存对安装的 WIM 映像的更改。

卸载安装的 WIM 映像。

从WIM 文件安装映像。

恢复孤立的 WIM 安装目录。

删除与损坏的安装的 WIM 映像关联的资源。

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

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

用英文显示命令行输出。

指定报告输出格式。

指定 Windows 目录的路径。

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

指定日志文件路径。

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

取消自动重新启动和重新启动提示。

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

指定暂存目录的路径。

WIM 命令: 详细介绍、格式及示例

WIM 命令: 详细介绍、格式及示例

/Get-MountedWimInfo显示有关安装映像的信息,包括映像是否可

用于提供服务,是否需要重新安装,或者是否为有效映像。

/Get-MountedWimInfo

示例: /Get-MountedWimInfo

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

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

示例:

/Get-WimInfo /WimFile:C:

/Get-WimInfo /WimFile:C:

/Get-WimInfo

/Index:1

/Commit-Wim

/Commit-Wim /MountDir:应用对安装的映像的更改。在使用 /Unmount-Wim选项之前,仍然安装映像。

示例: /Commit-Wim /MountDir:C:testoffline

/Unmount-Wim /MountDir: { /Commit |

/Discard} 卸载 WIM 文件。指定 /Commit 保存更改或指定

/Discard 放弃更改。

示例:

/Unmount-Wim /MountDir:C:testoffline /commit

/Unmount-Wim /MountDir:C:testoffline /discard

/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

/Unmount-Wim

/Mount-Wim

/Remount-Wim

/Cleanup-Wim

映像规格使用方法:

映像规格:

/Online

/Image

WINDOWS版本服务命令:

/Set-ProductKey

/Get-TargetEditions

/Set-Edition

无人参与服务命令:

/Apply-Unattend

驱动程序服务命令:

使用方法

以正在运行的操作系统为目标。此选项必须与服务命令一起使用。

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

示例: /Image:C:testoffline /Get-Packages

将产品密钥填充到脱机映像中。

显示可以将映像升级到的 Windows 版本的列表。

将 Windows 映像升级到较高版本。

将无人参与文件应用于映像。

/Get-CurrentEdition 显示指定映像的版本。

/Remove-Driver

/Add-Driver

/Get-DriverInfo

/Get-Drivers

国际服务命令:

/Set-LayeredDriver

/Set-UILang

/Set-UserLocale

/Set-SysLocale

/Set-InputLocale

/Set-TimeZone

/Set-AllIntl

/Set-SKUIntlDefaults

/Gen-LangIni

/Set-SetupUILang

/Get-Intl

应用程序服务命令:

/Check-AppPatch

/Get-AppPatchInfo

/Get-AppPatches

/Get-AppInfo

/Get-Apps

程序包服务命令:

/Add-Package

/Remove-Package

/Enable-Feature

/Disable-Feature

/Get-Packages

/Get-PackageInfo

/Get-Features

/Get-FeatureInfo

/Cleanup-Image

从脱机映像中删除驱动程序包。

向脱机映像中添加驱动程序包。

显示有关脱机映像中或正在运行的操作系统中的特定驱动程序的信息。

显示有关脱机映像中或正在运行的操作系统中的所有驱动程序的信息。

设置键盘分层驱动程序。

设置安装的脱机映像中使用的默认系统用户界面语言。

设置安装的脱机映像中的用户区域设置。

设置安装的脱机映像中的非 Unicode 程序的语言(也称为系统区域设置)和字体设置。

设置要在安装的脱机映像中使用的输入区域设置和键盘布局。

设置安装的脱机映像中的默认时区。

设置安装的脱机映像中的所有国际设置。

将安装的脱机映像中的指定 SKU 语言的所有国际设置都设置为默认值。

生成新的 文件。

定义安装程序将使用的默认语言。

显示有关国际设置和语言的信息。

显示有关 MSP 修补程序是否适用于安装的映像的信息。

显示有关安装的 MSP 修补程序的信息。

显示有关应用于所有安装的应用程序的所有MSP 修补程序的信息。

显示有关特定安装的 MSI 应用程序的信息。

显示有关安装的所有 MSI 应用程序的信息。

向映像中添加程序包。

从映像中删除程序包。

启用映像中的特定功能。

禁用映像中的特定功能。

显示有关映像中所有程序包的信息。

显示有关特定程序包的信息。

显示有关程序包中所有功能的信息。

显示有关特定功能的信息。

对映像执行清理和恢复操作。

/Set-UILangFallback 设置安装的脱机映像中系统用户界面的回滚默认语言。

DISM 选项: 详细介绍、格式及示例

DISM 选项: 详细介绍、格式及示例

/English

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

示例:

/Image:C:testoffline /Format:Table /English /Get-Packages

/Image:C:testoffline /English /Get-DriverInfo /Driver:

/格式:指定报告的输出格式。当与不生成报告的命令,或与不支持此选项的命令一起使用时,此选项无效。

接受的值为:Table = 采用表格格式显示报告。List = 采用名称 /值对列表格式显示报告。

示例:

/Image:C:testoffline /Format:Table /Get-Packages

/Image:C:testoffline /Format:List /Get-Features

/Image:C:testoffline /Format:Table /Get-Drivers

/Image:C:testoffline /Format:List /Get-Apps

/Image:C:testoffline /Format:Table /Get-AppPatches

/Image: [ /WinDir:] 指定相对于映像路径的 Windows 目录的路径。如果未指定,则它默认为

"Windows"。

注意:此选项不能与 /Online 选项一起使用。

示例: /Image:C:testoffline /WinDir:Win

/Format

/WinDir

/Image: [ /SysDriveDir:] 指定bootmgr文件的目录路径。如果未指定,则它默认为脱机映像路径。

/SysDriveDir

注意:此选项不能与 /Online 选项一起使用。

示例: /Image:C:testoffline /SysDriveDir:C:

/LogPath:指定 DISM 日志文件的路径。如果未指定,则默认值为%windir%。

示例:

/Image:C:testoffline /logpath:C:

/LogLevel:指定日志中所示的最大输出级别。

接受的值为:1 = 仅错误 2 = 错误和警告 3 = 错误、警告和信息 4 =

以上所有内容和调试输出如果未指定,则它默认为 3 (最大日志记录)。

示例:

/Image:C:testoffline /loglevel:1

/NoRestart取消重新启动提示。

示例: /Online /norestart

/Quiet 关闭控制台的信息和进度输出。只显示错误消息。

示例: /Image:C:testoffline /quiet

/LogPath

/LogLevel

/NoRestart

/Quiet

/ScratchDir:指定用来解压缩服务文件的临时目录。此目 /ScratchDir

录必须存在。如果未设置,则将使用此临时目录。

示例: /Image:C:testoffline /scratchdir:D:Scratch

服务命令详细说明:

WINDOWS版本服务命令:

/Set-ProductKey

/Set-ProductKey:将产品密钥填充到脱机映像中。

示例: /Image:C:testoffline

/Set-ProductKey:2T3TW-CKKO4-DJSSF-232DP-8RW0P

/Get-TargetEditions

/Get-CurrentEdition

/Set-Edition

无人参与服务命令:

/Get-TargetEditions显示可以将映像升级到的 Windows 版本的列表。

示例: /Image:C:testoffline /Get-TargetEditions

/Get-CurrentEdition显示当前映像的版本。

示例: /Image:C:testoffline /Get-CurrentEdition

/Set-Edition:将脱机映像升级到较高版本。使用

/Get-TargetEdition查找 edition-ID。

示例: /Image:C:testoffline /Set-Edition:"Ultimate"

/Apply-Unattend:将 文件应用于脱机映像或正在运行的操作系统。

示例:

/Image:C:testoffline /Apply-Unattend:C:

/Online /Apply-Unattend:C:

/Remove-Driver /Driver:

从映像中删除指定的全新驱动程序。使用 /Get-Drivers 可查看已安装驱动程序的列表。联机映像不支持此命令。

警告:删除启动关键驱动程序包可能会使脱机 Windows 映像无法启动。

示例: /Image:C:testoffline /Remove-Driver /Driver:

/Add-Driver { /Driver: |

/Driver:}[ /recurse] [ /ForceUnsigned]

向脱机映像中添加驱动程序。使用 /recurse可查询所有子文件夹中的驱动程序。使用 /ForceUnsigned可向基于 X64 的映像中添加未签名的驱动程序。联机映像不支持此命令。

示例:

/Image:C:testoffline /Add-Driver

/Driver:D:

/Image:C:testoffline /Add-Driver /Driver:D:Drivers /recurse

/Get-DriverInfo /Driver:

显示有关映像中已安装或尚未安装的 INF 文件的信息。已安装的第三方驱动程序将命名为 、 等。使用 /Get-Drivers 列表中已发布的名称可查看有关已安装驱动程序的信息。

示例:

/Image:C:testoffline /Get-DriverInfo

/Driver:D:

/Image:C:testoffline /Get-DriverInfo /Driver:

/Get-Drivers [ /Format:] [ /all]

显示有关映像中驱动程序的信息。使用 /Format 选项为输出指定表或列表格式。如果 /Format 未指定,则输出的格式为列表。默认情况下,只显示全新驱动程序。使用/all 开关可显示映像中所有驱动程序。

/Apply-Unattend

驱动程序服务命令:

/Remove-Driver

/Add-Driver

/Get-DriverInfo

/Get-Drivers

示例:

/Image:C:testoffline /Get-Drivers

/Image:C:testoffline /Get-Drivers /all

/Image:C:testoffline /Get-Drivers /Format:Table

国际服务命令:

/Set-LayeredDriver:

设置键盘分层驱动程序,可能的值为 1 到 6,定义如下:

1: PC /AT 增强的键盘(101 /102 个键)。

2: 朝鲜语 PC /AT 101 个键兼容键盘 /MS 自然键盘(类型 1)。

3: 朝鲜语 PC /AT 101 个键兼容键盘 /MS 自然键盘(类型 2)。

4: 朝鲜语 PC /AT 101 个键兼容键盘 /MS 自然键盘(类型 3)。

5: 朝鲜语键盘(103 /106 个键)。

6: 日语键盘(106 /109 个键)。

示例: /Image:C:testoffline /Set-LayeredDriver:1

/Set-UILang:

设置安装的脱机映像中使用的默认系统用户界面语言。如果此语言未安装在 Windows 映像中,则此命令将失败。联机映像不支持此命令。

示例: /Image:C:testoffline /Set-UILang:en-US

/Set-UILangFallback:

设置安装的脱机映像中系统用户界面的回滚默认语言。仅在由

/Set-UILang选项指定的语言是未完全本地化的语言时才使用此设置。联机映像不支持此命令。

示例: /Image:C:testoffline /Set-UILangFallback:en-US

/Set-UserLocale:

设置安装的脱机映像中的“标准和格式”语言(也称为用户区域设置)。“标准和格式”语言是每个用户的设置,该设置确定用于格式化日期、时间、货币和数字的默认排序顺序和默认设置。联机映像不支持此命令。

示例: /Image:C:testoffline /Set-UserLocale:en-US

/Set-SysLocale:

设置安装的脱机映像中的非 Unicode 程序的语言(也称为系统区域设置)和字体设置。联机映像不支持此命令。

警告:不能仅将 Unicode 语言设置为系统区域设置。如果尝试这样做,

/Set-SysLocale选项将失败并且将不会更改非 Unicode 程序的语言。

示例: /Image:C:testoffline /Set-SysLocale:en-US

/Set-InputLocale:{ | :}

设置要在安装的脱机映像中使用的输入区域设置和键盘布局。联机映像不支持此命令。

示例:

/Image:C:testoffline /Set-InputLocale:zh-CN

/Image:C:testoffline /Set-InputLocale:0804:00000804

/Set-TimeZone:设置 Windows 映像中的默认时区。设置时区之前,DISM 验证指定的时区字符串对于该映像是否有效。联机映像不支持此命令。

/Set-LayeredDriver

/Set-UILang

/Set-UILangFallback

/Set-UserLocale

/Set-SysLocale

/Set-InputLocale

/Set-TimeZone

示例: /Image:C:testoffline /Set-TimeZone:"W. Europe

Standard Time"

/Set-AllIntl:

将安装的脱机映像中的默认系统用户界面语言、非 Unicode 程序的语言、“标准和格式”语言和输入区域设置以及键盘布局设置为指定的语言。如果与用来指定单个语言或区域设置的任何选项一起使用,则单个设置将优先。联机映像不支持此命令。

示例: /Image:C:testoffline /Set-AllIntl:en-US

/Set-SKUIntlDefaults:

将安装的脱机映像中的默认系统用户界面语言、非 Unicode 程序的语言、“标准和格式”语言和输入区域设置、键盘布局和时区值设置为由指定的 Windows 7 默认值。联机映像不支持此命令。

示例: /Image:C:testoffline /Set-SKUIntlDefaults:en-US

/Gen-LangIni /Distribution:

生成一个新的 文件,安装程序使用该文件定义映像内和分发外的语言包。还定义安装程序的默认用户界面语言。此新的

文件将被添加到 Windows 分发的源文件夹中。联机映像不支持此命令。分发是一个包含您安装了 Windows 产品的源文件的文件夹。它可能还包含其他设备驱动程序和应用程序文件。

警告:将不提示您允许覆盖现有的 文件。现有的 文件将被覆盖。

示例: /Image:C:testoffline /Gen-LangIni

/Distribution:D:distribution

/Set-SetupUILang:

定义安装程序将使用的默认语言。如果此语言不能使用,则安装程序将回滚到英文。联机映像不支持此命令。需要分发路径。

示例: /Image:C:image

/Distribution:c:dist/Set-SetupUILang:en-US

/Get-Intl [ /Distribution:]

显示有关国际设置和语言的信息。使用 /Online 选项可显示有关正在运行的操作系统中的国际设置和语言的信息。使用 /Image 可显示有关脱机映像中国际设置和语言的信息。将 /Image 和 /Distribution 选项一起使用时,将显示有关分发中的国际设置和语言的信息。

警告:仅为脱机映像报告默认的用户区域设置和位置。该报告不包含正在运行的操作系统的此设置。

示例:

/Online /Get-Intl

/Image:C:testoffline /Get-Intl

/Image:C:testoffline /Get-Intl /Distribution:D:distribution

/Check-AppPatch /PatchLocation:

[ /Format:]

显示 MSP 修补程序是否适用于脱机映像的信息。可以指定多个修补/Set-AllIntl

/Set-SKUIntlDefaults

/Gen-LangIni

/Set-SetupUILang

/Get-Intl

应用程序服务命令:

/Check-AppPatch

程序文件。使用 /Format 选项为输出指定表或列表格式。如果没有指定 /Format,则输出的格式为列表。联机映像不支持此命令。

示例:

/Image:C:testoffline /Check-AppPatch

/PatchLocation:C:

/Get-AppPatchInfo [ /Format:]

[ /PatchCode:]

[ /ProductCode:]

显示有关安装的 MSP 修补程序的信息。如果指定了 /PatchCode,则显示应用修补程序的所有 MSI 应用程序的信息。如果指定了

/ProductCode,则显示有关指定的应用程序中的所有修补程序的信息。如果指定了两者,则只有当修补程序应用于指定应用程序时才显示信息。使用 /Get-AppPatches可查找修补程序代码 GUID 和产品代码

GUID。使用 /Get-Apps 可列出某个安装的应用程序的所有产品代码

GUID。如果未指定 /PatchCode和 /ProductCode,则显示所有安装的

MSI程序包和 MSP 修补程序。使用 /Format 选项为输出指定表格或/Get-AppPatchInfo

列表格式。如果未指定 /Format,则将输出格式化为列表。联机映像不支持该命令。

示例:

/Image:C:testoffline /Get-AppPatchInfo

/Image:C:testoffline /Get-AppPatchInfo

/PatchCode:{7B477EF4-D848-492B-BA85-0297B1AF4F36}

/Image:C:testoffline /Get-AppPatchInfo

/ProductCode:{A13BF3E2-0C87-4DC3-B555-42EA2ED666E3}

/Image:C:testoffline /Get-AppPatchInfo

/PatchCode:{7B477EF4-D848-492B-BA85-0297B1AF4F36}

/ProductCode:{A13BF3E2-0C87-4DC3-B555-42EA2ED666E3}

/Get-AppPatches [ /Format:]

[ /ProductCode:]

显示有关应用于脱机映像上安装的所有应用程序的所有MSP 修补程序的信息。如果指定了产品代码 GUID,则显示有关指定的 MSI 应用程序中的所有修补程序的信息。使用 /Format 选项为输出指定表格或列表格式。如果未指定 /Format,则将输出格式化为列表。联机映像不支持该命令。

示例:

/Image:C:testoffline /Get-AppPatches

/Image:C:testoffline /Get-AppPatches

/ProductCode:{A13BF3E2-0C87-4DC3-B555-42EA2ED666E3}

/Get-AppInfo [ /Format:]

[ /ProductCode:]

显示有关安装的特定 Windows Installer (MSI)应用程序的详细信息。使用 /Get-Apps 选项可查找安装的 Windows Installer (MSI)应用程序的

GUID。如果未指定产品代码 GUID,则显示安装的脱机映像中安装的所有WindowsInstaller (MSI)应用程序的信息。使用 /Format 选项为输/Get-AppPatches

/Get-AppInfo

出指定表格或列表格式。如果未指定 /Format,则将输出格式化为列表。联机映像不支持该命令。

示例:

/Image:C:testoffline /Get-AppInfo

/Image:C:testoffline /Get-AppInfo

/ProductCode:{A13BF3E2-0C87-4DC3-B555-42EA2ED666E3}

/Get-Apps [ /Format:]

显示脱机映像中的所有 MSI 应用程序的信息。使用 /Format 选项为输出指定表格或列表格式。如果未指定 /Format,则将输出格式化为列表。联机映像不支持该命令。

示例: /Image:C:testoffline /Get-Apps

/Add-Package /PackagePath: [ /IgnoreCheck]

向映像中添加一个或多个程序包。 /PackagePath可以指向 .cab 文件、.msu文件或文件夹。如果适用性检查失败,使用 /IgnoreCheck开关可跳过安装程序包。

示例:

/Image:C:testoffline /Add-Package

/PackagePath:C:testpackages /IgnoreCheck

/Image:C:testoffline /Add-Package

/PackagePath:C:

/Image:C:testoffline /Add-Package

/PackagePath:C:

/Remove-Package { /PackagePath: |

/PackageName:}

如果未执行联机、未处理的挂起操作,则删除一个或多个程序包。如果联机操作挂起,则资源仍然位于映像中并且程序包状态设置为“请求的卸载”。必须启动映像以处理挂起的操作,才能删除程序包。不能使用此命令删除 .msu文件。

示例:

/Image:C:testoffline /Remove-Package

/PackagePath:C:

/Image:C:testoffline /Remove-Package

/PackageName:~6595b6144ccf1df~x86~en~1.0.0.0

/Enable-Feature /FeatureName:

[ /PackageName:]

启用指定的功能。如果未指定程序包名称,则使用 Windows Foundation

程序包。功能名称区分大小写。

示例:

/Image:C:testoffline /Enable-Feature

/FeatureName:XPS-Viewer

/Image:C:testoffline /Enable-Feature /FeatureName:Calc

/PackageName:~6595b6144ccf1df~x86~en/Get-Apps

程序包服务命令:

/Add-Package

/Remove-Package

/Enable-Feature

~1.0.0.0

/Disable-Feature /FeatureName:

[ /PackageName:]

禁用指定的功能。如果未指定程序包名称,则使用 Windows Foundation

程序包。功能名称区分大小写。

示例:

/Image:C:testoffline /Disable-Feature

/FeatureName:XPS-Viewer

/Image:C:testoffline /Disable-Feature /FeatureName:Calc

/PackageName:~6595b6144ccf1df~x86~en~1.0.0.0

/Get-Packages [ /Format:]

显示有关映像中所有程序包的信息。使用 /Format 选项为输出指定表格或列表格式。如果未指定 /Format,则将输出格式化为列表。

示例:

/Image:C:testoffline /Get-Packages

/Format:Table /Image:C:testoffline /Get-Packages

/Format:List /English /Image:C:testoffline /Get-Packages

/Get-PackageInfo{ /PackagePath: |

/PackageName:}

显示有关特定程序包的信息。 /PackagePath可以指向 .cab 文件或文件夹。.cab 文件的路径应该指向此程序包的原始源,而不指向该文件安装在映像上的位置。无法使用此命令获取 .msu文件的程序包信息。

示例:

/Image:C:testoffline /Get-PackageInfo

/PackagePath:C:

/Image:C:testoffline /Get-PackageInfo

/PackageName:~6595b6144ccf1df~x86~en~1.0.0.0

/Get-Features [ /Format:]

[ /PackagePath:][ /PackageName:]

显示有关在特定程序包中找到的所有功能的信息。如果您未指定程序包名称或路径,则将列出映像中的所有功能。 /PackagePath可以指向 .cab 文件或文件夹。使用 /Format 选项为输出指定表格或列表格式。如果未指定 /Format,则将该选项格式化为列表。

示例:

/Image:C:testoffline /Get-Features /Format:Table

/Image:C:testoffline /Get-Features /Format:List

/PackagePath:C:

/Image:C:testoffline /Get-Features

/PackageName:~6595b6144ccf1df~x86~en~1.0.0.0

/Get-FeatureInfo

/FeatureName:[ /PackagePath:]

/Disable-Feature

/Get-Packages

/Get-PackageInfo

/Get-Features

/Get-FeatureInfo

[ /PackageName:]

显示有关特定功能的信息。使用 /Get-Features 在映像中查找功能的名称。功能名称区分大小写。可以使用 /PackageName和 /PackagePath在程序包中查找特定功能。

示例:

/Image:C:testoffline

/Get-FeatureInfo/FeatureName:XPS-Viewer

/Image:C:testoffline /Get-FeatureInfo /FeatureName:Feature

/PackagePath:C:

/Cleanup-Image /RevertPendingActions警告! 此操作将从以前的服务操作中还原挂起的操作。此操作应只用于恢复操作。此命令在联机映像上不受支持。

示例: /Image:C:testoffline /Cleanup-Image

/RevertPendingActions

/Cleanup-Image /spsuperseded [ /hidesp] 警告! 完成此操作之后将无法卸载 Service Pack。此操作将删除 Service Pack

安装期间创建的备份文件。使用 /hidesp开关从已安装更新中隐藏

Service Pack。

示例: /Image:C:testoffline /Cleanup-Image /spsuperseded

/hidesp

/Cleanup-Image