操作系统程序包服务命令行选项

可以脱机使用操作系统程序包服务命令来安装、删除或更新以 CAB (.cab) 文件或 Windows Update 独立安装程序 (.msu) 文件形式提供的 Windows(R) 程序包。Microsoft(R) 使用程序包来分发软件更新、Service Pack 和语言包。程序包还可以包含 Windows 功能。您还可以使用这些服务命令在脱机情况下或在运行 Windows 安装时启用或禁用 Windows 功能。功能是核心操作系统的可选组件。

使用 DISM 处理 Windows 映像的基本语法为：

DISM.exe {/Image:<path_to_ image_directory> | /Online} [dism_options] {servicing_command} [<servicing_argument>]

下列操作系统程序包服务选项可用于脱机映像：

DISM.exe /image:<path_to_ image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ]

下列操作系统程序包服务选项可用于处于运行状态的操作系统：

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ]

下表描述了如何使用每个操作系统程序包服务选项。这些选项不区分大小写。但是，功能名称区分大小写。

选项 参数 说明
/Get-Help

/?
  如果在某个程序包服务命令行选项后紧接着使用此选项，则会显示有关该命令行选项及其参数的信息。

其他某些主题可能会在指定了映像之后变为可用。

示例：


Dism /image:C:\test\offline /Add-Package /?



Dism /online /Get-Packages /?


/Get-Packages
/Format:Table

/Formatist
显示有关映像中所有程序包的基本信息。使用 /Format:Table 或 /Formatist 参数可以采用表或列表形式显示输出。

示例：


Dism /image:C:\test\offline /Get-Packages



Dism /image:C:\test\offline /Get-Packages /Format:Table



Dism /online /Get-Packages


/Get-PackageInfo
/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>
显示有关以 .cab 文件形式提供的程序包的详细信息。只能指定 .cab 文件。无法使用此命令来获取 .msu 文件的程序包信息。/PackagePath 可以指向 .cab 文件或文件夹。

您可以使用 /Get-Packages 选项在映像中查找该程序包的名称，也可以指定 .cab 文件的路径。.cab 文件的路径应指向该程序包的原始源，而不是指向该文件在脱机映像中的安装位置。

示例：


Dism /image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab



Dism /image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0


/Add-Package
/PackagePath:<path_to_cabfile>

/IgnoreCheck
在映像中安装指定的 .cab 程序包或 .msu 程序包。您可以通过一个命令行添加多个程序包。系统将检查每个程序包的适用性。如果程序包不适用于指定的映像，则您将收到一条错误消息。如果要通过该命令直接处理而不检查每个程序包的适用性，请使用 /IgnoreCheck 参数。

/PackagePath 可以指向：

单个 .cab 文件或 .msu 文件

包含单个展开的 .cab 文件的文件夹

包含单个 .msu 文件的文件夹

包含多个 .cab 文件或 .msu 文件的文件夹

示例：


Dism /image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.cab



Dism /image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath: C:\packages\package2.cab /ignorecheck


/Remove-Package
/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>
从映像中删除指定的 .cab 文件包。只能指定 .cab 文件。无法使用此命令删除 .msu 文件。

注意：  
使用此命令从 Windows 预安装环境 (Windows PE) 映像中删除程序包不会恢复映像中的任何空间。



您可以使用 /PackagePath: 选项指向该程序包的原始源、指定 CAB 文件的路径，也可以按映像中列出的名称指定程序包。使用 /Get-Packages 选项可以在映像中查找该程序包的名称。

示例：


Dism /image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0



Dism /image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0



Dism /image:C:\test\offline /LogPath:RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath: C:\packages\package2.cab


/Get-Features
/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>

/Format:Table

/Format:List
显示有关程序包中的所有功能（包括可选的 Windows Foundation 功能在内的操作系统组件）的基本信息。您可以使用 /Get-Features 选项在映像中查找该程序包的名称，也可以指定该程序包的原始源的路径。如果未指定程序包名称或路径，则将列出映像中的所有功能。/PackagePath 可以指向 .cab 文件或文件夹。

功能名称区分大小写。

使用 /Format:Table 或 /Format:List 参数可以采用表或列表形式显示输出。

示例：


Dism /image:C:\test\offline /Get-Features



Dism /image:C:\test\offline /Get-Features /Format:List



Dism /image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0



Dism /image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab


/Get-FeatureInfo
/FeatureName:<name_in_image>

/PackageName:<name_in_image>

/PackagePath:<path_to_cabfile>
显示有关某项功能的的详细信息。您必须使用 /FeatureName。您可以使用 /Get-Features 选项在映像中查找该功能的名称。功能名称区分大小写。

/PackageName 和 /PackagePath 是可选的，而且可用于在程序包中查找某项特定的功能。

示例：


Dism /image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts



Dism /image:C:\test\offline /Get-FeatureInfo /FeatureName:Feature /PackagePath:C:\packages\package.cab


/Enable-Feature
/FeatureName:<name_in_image>

/PackageName:<name_in_image>

/PackagePath: <path_to_package>>
启用或更新映像中指定的功能。您必须使用 /FeatureName 选项。使用 /Get-Features 选项可以在映像中查找该功能的名称。功能名称区分大小写。

如果是 Windows Foundation 程序包，则不需要指定 /PackageName。

请使用 /PackagePath 指向该程序包的原始源。如果尚未安装该程序包，则将安装并启用它。

示例：


Dism /image:C:\test\offline /Enable-Feature /FeatureName:Hearts



Dism /image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackagePath:C:\packages\Calc.cab



Dism /image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0


/Disable-Feature
/FeatureName:<name_in_image>

/PackageName:<name_in_image>
禁用映像中的指定功能。您必须使用 /FeatureName 选项。使用 /Get-Features 选项可以在映像中查找该功能的名称。

功能名称区分大小写。

示例：


Dism /image:C:\test\offline /Disable-Feature /FeatureName:Hearts



Dism /image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0


/Cleanup-Image
/RevertPendingActions
对映像执行清理或恢复操作。

如果您遇到启动故障，则可以使用 /RevertPendingActions 选项来尝试执行系统恢复。该操作将从以前的服务操作中还原所有挂起的操作，因为以前的操作可能就是启动故障的原因所在。/RevertPendingActions 选项在处于运行状态的操作系统、Windows PE 或 Windows 恢复环境 (Windows RE) 映像中不受支持。

重要信息：  
在系统恢复方案中，您只应使用 /RevertPendingActions 选项对无法启动的 Windows 映像执行恢复操作。



示例：


DISM /Image:C:\test\offline /Cleanup-Image /RevertPendingActions


限制在脱机映像中安装程序包时，由于挂起的联机操作，程序包状态为“安装挂起”。换句话说，将在启动映像并处理联机操作时安装程序包。如果请求后续操作，则完成前面挂起的联机操作后，才会处理这些后续操作。
如果某个程序包处于“安装挂起”状态，随后您暂存了该程序包，则该程序包状态将被设置为“卸载挂起”。这是因为该程序包必须在暂存之前进行卸载。

某些程序包要求首先安装其他程序包。您不应假设会满足依存关系。如果存在依存关系要求，则应使用答案文件来安装必要的程序包。通过将答案文件传送到 DISM，多个程序包可以按正确的顺序进行安装。这是安装多个程序包的首选方法。

程序包按照它们在命令行中列出的顺序进行安装。

使用 DISM 列出 Windows PE 映像中的功能包时，这些程序包始终会以挂起状态列出，即使服务操作成功也是如此。这是由设计决定的，不需要您执行进一步的操作。