Skip to main content
Перейти к основному контенту
Параметры командной строки DISM для обслуживания пакетов операционной системы

Обновлено: Октябрь 2013 г.

Назначение: Windows 8, Windows 8.1, Windows Server 2012, Windows Server 2012 R2

Команды обслуживания пакетов операционной системы можно использовать автономно для установки, удаления и обновления пакетов Windows (R), предоставленных в виде CAB-файлов или файлов автономного установщика обновлений Windows (MSU-файлов). Корпорация Майкрософт (R) использует пакеты для распространения обновлений программного обеспечения, пакетов обновления и языковых пакетов. Пакеты могут также содержать отдельные компоненты Windows. Эти команды обслуживания также можно использовать, чтобы включить или отключить функциональные возможности Windows как в автономном образе, так и в работающей операционной системе Windows. Функциональные возможности являются дополнительными компонентами для базовой операционной системы.

Для обслуживания образа Windows с помощью системы DISM используется следующий основной синтаксис:

DISM.exe {/Image:<путь_к_каталогу_образа> | /Online} [глобальные_параметры_dism] {параметр_обслуживания} [<аргумент_обслуживания>]

Для автономного образа доступны следующие параметры обслуживания пакетов операционной системы:

DISM.exe /Image:<путь_к_каталогу_образа> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

Для работающей операционной системы доступны следующие параметры обслуживания пакетов операционной системы:

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

В этом разделе подробно объясняется использование каждого из параметров обслуживания пакетов операционной системы. Регистр символов при использовании этих параметров не учитывается. При обслуживании не Windows(R) 8, а другого образа Windows имена компонентов должны вводиться с учетом регистра.

При использовании сразу после параметра командной строки, предназначенного для обслуживания пакетов, выводит сведения о параметре и аргументах.

Если указать образ, могут стать доступными дополнительные сведения.

Примеры.

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

Dism /Online /Get-Packages /?

Выводит основные сведения обо всех пакетах в образе. Аргумент /Format:Table или /Format:List используется для отображения результата в виде таблицы или списка.

Примеры.

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

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

Dism /Online /Get-Packages

Отображает подробные сведения о пакете, предоставленном в виде 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

Устанавливает указанный CAB- или MSU-пакет в образ. С помощью одной команды можно добавить несколько пакетов. Будет проверена возможность применения каждого пакета. Если пакет неприменим к указанному образу, будет выведено сообщение об ошибке. Аргумент /IgnoreCheck можно использовать, если нужно, чтобы команда обрабатывалась без проверки применимости каждого пакета.

Параметр /PreventPending можно использовать, чтобы пропустить установку пакета, если пакет или образ Windows имеет ожидающие сетевые действия. Этот параметр можно использовать только при обслуживании образов Windows 8, Windows Server 2012 или Среда предустановки Windows(R) версии 4.0.

/PackagePath может указывать на следующие объекты:

  • отдельный CAB- или MSU-файл;

  • папку, содержащую один развернутый CAB-файл;

  • папку, содержащую один MSU-файл;

  • папку, содержащую несколько CAB-файлов или MSU-файлов.

noteПримечание
Если параметр /PackagePath указывает на папку, содержащую CAB- или MSU-файлы в корне, любые вложенные папки также будут проверены на наличие CAB- и MSU-файлов.

Примеры.

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

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

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

Удаляет пакет указанного CAB-файла из образа. Можно указать только CAB-файлы. Эту команду нельзя использовать для удаления MSU-файлов.

noteПримечание
Эта команда позволяет удалить пакет из автономного образа без уменьшения размера образа.

Команда /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:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

Выводит основные сведения обо всех функциональных возможностях (компонентах операционной системы, содержащих дополнительные возможности базового пакета Windows) в пакете. Для поиска имени пакета в образе можно использовать параметр /Get-Features или можно указать путь к первоначальному источнику пакета. Если для пакета не заданы имя или путь, будут перечислены все компоненты, содержащиеся в образе. /PackagePath может указывать либо на CAB-файл, либо на папку.

При обслуживании не Windows 8, а другого образа Windows имена компонентов должны вводиться с учетом регистра.

Аргумент /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

Выводит подробные сведения о компоненте. Необходимо использовать параметр /FeatureName. При обслуживании не Windows 8, а другого образа Windows имена компонентов должны вводиться с учетом регистра. Для поиска имени компонента в образе можно использовать параметр /Get-Features.

/PackageName и /PackagePath являются необязательными и могут быть использованы для поиска конкретного компонента в пакете.

Примеры.

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

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

Включает или обновляет указанный компонент в образе. Необходимо использовать параметр /FeatureName. При обслуживании не Windows 8, а другого образа Windows имена компонентов должны вводиться с учетом регистра. Чтобы найти имя компонента в образе, воспользуйтесь командой /Get-Features.

Параметр /FeatureName можно использовать в командной строке несколько раз, чтобы указать несколько компонентов в одном родительском пакете.

Для пакета Windows Foundation Package не нужно указывать имя пакета с помощью параметра /PackageName. Во всех остальных случаях, чтобы указать родительский пакет компонента, используйте параметр /PackageName.

Вы можете восстановить и включить компонент, который ранее был удален из образа. С помощью аргумента /Source можно указать расположение файлов, необходимых для восстановления компонента. Источником файлов может быть папка Windows в подключенном образе, например c:\test\mount\Windows. В качестве источника файлов можно использовать папку Windows SxS, например: z:\sources\SxS.

Если указано несколько аргументов /Source, файлы собираются из первого расположения, в котором они были найдены, а оставшиеся расположения игнорируются. Если аргумент /Source для удаляемого компонента не указан, то используется расположение по умолчанию, указанное в реестре, а для образов в сети используется Центр обновления Windows.

Чтобы запретить DISM обращение к Центру обновления Windows для восстановления образов в сети, используйте аргумент/LimitAccess.

Используйте аргумент /All, чтобы включить все родительские возможности указанного компонента.

Аргументы /Source, /LimitAccess и /All можно использовать только при обслуживании образов Windows 8, Windows Server 2012 или Среда предустановки Windows(R) версии 4.0.

Примеры.

Dism /Online /Enable-Feature /FeatureName:Hearts /All

Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess

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

Отключает указанный компонент в образе. Необходимо использовать параметр /FeatureName. При обслуживании не Windows 8, а другого образа Windows имена компонентов должны вводиться с учетом регистра. Чтобы найти имя компонента в образе, воспользуйтесь командой /Get-Features.

Параметр /FeatureName можно использовать в командной строке несколько раз, чтобы указать несколько компонентов в одном родительском пакете.

Для пакета Windows Foundation Package не нужно указывать имя с помощью параметра /PackageName. Во всех остальных случаях, чтобы указать родительский пакет компонента, используйте параметр /PackageName.

С помощью параметра /Remove можно удалить компонент, сохранив манифест компонента в образе. Этот параметр можно использовать только при обслуживании образов Windows 8 или Windows Server 2012. При использовании команды /Get-FeatureInfo для отображения сведений о компоненте компонент будет иметь пометку "Удален". Кроме того, его нельзя будет восстановить и включить с помощью команды /Enable-Feature с параметром /Source.

Примеры.

Dism /Online /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

Выполняет операции очистки или восстановления образа.

В случае сбоя при загрузке можно попытаться выполнить восстановление системы с помощью параметра /RevertPendingActions. Эта операция отменяет все ожидающие действия предыдущих операций обслуживания, так как эти действия могут быть причиной сбоя при загрузке. Параметр /RevertPendingActions не поддерживается для работающей операционной системы, а также для образов среды предустановки или среды восстановления Windows.

ImportantВажно
Параметр /RevertPendingActions следует использовать только в сценарии восстановления системы образа Windows, при загрузке которого произошел сбой.

Для удаления всех резервных копий файлов, созданных в процессе установки пакета обновления, используйте параметр /SPSuperseded. С помощью параметра /HideSP можно запретить перечисление пакета обновления в списке Установленные обновления панели управления.

ImportantВажно
После выполнения операции /SPSuperseded будет невозможно удалить пакет обновления.

Параметр /StartComponentCleanup можно использовать для удаления замененных компонентов и уменьшения размера хранилища компонентов. Используйте параметр /ResetBase, чтобы восстановить исходное состояние базы замененных компонентов для уменьшения впоследствии размера хранилища компонентов.

WarningПредупреждение
После выполнения команды /StartComponentCleanup с параметром /ResetBase нельзя будет удалить установленные обновления Windows.

Параметр /AnalyzeComponentStore используется для создания отчета о хранилище компонентов. Подробнее об отчетах и использовании предоставляемой отчетами информации: http://go.microsoft.com/fwlink/?LinkId=293367.

С помощью параметра /CheckHealth можно проверить, был ли образ помечен как поврежденный незавершенным в результате ошибки процессом и можно ли исправить повреждение.

Параметр /ScanHealth используется для сканирования образа с целью поиска повреждений в хранилище компонентов. Эта операция может занять несколько минут.

Используйте параметр /RestoreHealth для сканирования образа и поиска повреждений в хранилище компонентов с последующим автоматическим выполнением операции восстановления. Эта операция может занять несколько минут.

Параметр /Source с /RestoreHealth используется для того, чтобы указать расположение заведомо неповрежденных версий файлов, которые можно использовать для восстановления, например путь к каталогу Windows подключенного образа.

Если для /Source указано несколько аргументов, файлы собираются из первого расположения, в котором они были найдены, а оставшиеся расположения игнорируются. Если параметр /Source для удаляемого компонента не указан, то используется расположение по умолчанию, указанное в реестре, а для образов в сети используется Центр обновления Windows.

Чтобы запретить DISM обращение к Центру обновления Windows для восстановления образов в сети, используйте параметр /LimitAccess.

/AnalyzeComponentStore и /ResetBase нельзя использовать при обслуживании более ранних по сравнению с образами Windows 8.1 или Windows Server 2012 R2 версий Windows.

/StartComponentCleanup нельзя использовать при обслуживании более ранних по сравнению с образами Windows 8 или Windows Server 2012 версий Windows.

/CheckHealth, /ScanHealth, /RestoreHealth, /Source и /LimitAccess нельзя использовать при обслуживании более ранних по сравнению с образами Windows 8 или Windows Server 2012 версий Windows.

/HideSP и /SPSuperseded нельзя использовать при обслуживании более ранних по сравнению с образом Windows(R) 7 с пакетом обновления 1 (SP1) версий Windows.

Примеры.

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

Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP

Dism /Online /Cleanup-Image /ScanHealth

Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

  • При установке пакета в автономный образ из-за ожидающих сетевых действий пакет будет иметь состояние "ожидается установка". Другими словами, пакет будет установлен после того, как образ будет загружен, а ожидающие сетевые действия выполнены. Если запрашиваются последующие действия, они не могут быть обработаны до завершения предыдущего ожидающего сетевого действия. Параметр /PreventPending, если он используется при добавлении пакета с помощью /AddPackage, позволяет пропустить установку пакета при наличии ожидающих сетевых действий.

  • Для установки некоторых пакетов требуется предварительно установить другие пакеты. Не следует считать, что при установке все зависимости будут удовлетворяться автоматически. При наличии требований к зависимостям для установки необходимых пакетов следует использовать файл ответов. С помощью передачи файла ответов в DISM можно установить несколько пакетов в нужном порядке. Это рекомендуемый способ установки нескольких пакетов. Подробнее см. в разделе об Добавление или удаление пакетов в автономном режиме с помощью DISM.

  • Пакеты устанавливаются в том порядке, в котором они перечислены в командной строке.

  • При использовании DISM для вывода списков дополнительных компонентов в образе среды предустановки Windows дополнительные компоненты всегда будут перечисляться как ожидающие, даже если операция обслуживания была успешно выполнена. Это предусмотрено алгоритмом программы и не требует от пользователя никаких дополнительных действий.