Поделиться через

Параметры командной строки обслуживания пакета операционной системы DISM (.cab или MSU)

  • Статья

Используйте DISM с шкафом Windows (.cab) или Обновл. Windows автономными файлами установщика (MSU) для установки или удаления обновлений, языковых пакетов и включения или отключения функций Windows. Функции являются необязательными компонентами для основной операционной системы.

Синтаксис

DISM.exe {/Image:<path_to_image_directory> | /Online} [dism_global_options] {servicing_option} [<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 ] [/Cleanup-Image]

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

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

/Get-Help /?

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

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

Синтаксис

Dism /Get-Help

Примеры:

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

Dism /Online /Get-Packages /?

/Get-Packages

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

Синтаксис

Dism /Get-Packages [/Format:{Table | List}]

Примеры:

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

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

Dism /Online /Get-Packages

/Get-PackageInfo

Отображает подробные сведения о пакете, предоставленном в виде файла .cab. Можно указать только .cab файлы. Эту команду нельзя использовать для получения сведений о пакете для MSU-файлов. /PackagePath:<path_to_package> может указывать на файл .cab или папку.

Можно использовать /Get-Packages параметр для поиска имени пакета в изображении или указать путь к файлу .cab. Путь к файлу .cab должен указывать на исходный источник пакета, а не на место установки файла в автономном образе.

Синтаксис

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

Примеры:

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

Устанавливает указанный пакет .cab или MSU в образе.

Примечание.

Можно использовать /Add-Package для добавления пакета MSU в сетевой или автономный образ Windows 11, версии 21H2 или более поздней версии. Если вы работаете с образом Windows до Windows 11 версии 21H2, вы можете добавлять только пакеты MSU в автономные целевые образы.

Несколько пакетов можно добавить в одну командную строку. Будет проверено применимость каждого пакета. Если пакет не может быть применен к указанному изображению, появится сообщение об ошибке. Используйте аргумент /IgnoreCheck, если вы хотите, чтобы команда обрабатывала без проверки применимости каждого пакета.

Синтаксис

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]

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

    • Один .cab или MSU-файл.
    • Папка, содержащая один развернутый .cab-файл.
    • Папка, содержащая один MSU-файл.
    • Папка, содержащая несколько .cab или MSU-файлов.

  • Если /PackagePath указывает на папку, содержащую .cab или MSU-файлы в корневом каталоге, все вложенные папки также будут рекурсивно проверяться на наличие .cab и MSU-файлов.

  • /PreventPending Используйте параметр, чтобы пропустить установку пакета, если пакет или образ Windows имеют ожидающие действия в Сети.

Примечание.

/Add-Package не выполняет полную проверку применимости и зависимостей пакета:

  • Если вы добавляете пакет с зависимостями, убедитесь, что все зависимости установлены при добавлении пакета.
  • Если вы добавляете 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

Накопительные обновления контрольной точки

Начиная с Windows 11 версии 24H2, последнее накопительное обновление может иметь предварительный накопительный пакет обновления, который требуется сначала установить. Чтобы установить эти накопительные обновления контрольной точки, вызовите /Add-Package с целевым накопительным обновлением. Папка из -PackagePath будет использоваться для обнаружения и установки одной или нескольких контрольных точек по мере необходимости. Только целевое накопительное обновление и все накопительные обновления контрольной точки необходимых компонентов должны находиться в папке -PackagePath. Накопительные пакеты обновления с редакцией меньше или равно целевому накопительным обновлениям будут обработаны.

/Remove-Package

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

Примечание.

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

Синтаксис

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Используйте /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

/Get-Features

Отображает основные сведения обо всех компонентах (компонентах операционной системы, которые включают необязательные компоненты Windows Foundation) в пакете.

Синтаксис

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features находит имя пакетов на изображении или в исходном источнике пакета. Если не указать имя пакета или путь, будут перечислены все функции в изображении.
  • /PackageName — это пакет на изображении. Имена пакетов можно использовать для /DISM Get-Packages просмотра имен пакетов на изображении.
  • /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. Вы можете использовать /Get-Features этот параметр, чтобы найти имя функции на изображении.

Синтаксис

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/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

/Enable-Feature

Включает или обновляет указанную функцию на изображении. Этот параметр необходимо использовать /FeatureName . /Get-Features Используйте параметр, чтобы найти имя функции на изображении.

Синтаксис

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

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

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

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

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

  • Используйте, /LimitAccess чтобы запретить DISM связаться с WU для онлайн-образов.
  • Используйте /All для включения всех родительских функций указанной функции.

Примеры:

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

/Disable-Feature

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

Синтаксис

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

Можно указать /FeatureName несколько раз в одной командной строке для функций в одном родительском пакете.

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

Используйте /Remove для удаления функции, не удаляя манифест компонента из образа. Функция будет указана как "Удаленная" при /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

/Cleanup-Image

Выполняет операции очистки или восстановления образа. /AnalyzeComponentStore и /ResetBase можно использовать с образами Windows 10, Windows 8.1 и Windows PE выше 5.0. Начиная с Windows 10 версии 1607, можно указать /Defer с /ResetBaseпомощью, но вы должны использовать /Defer только в качестве параметра в фабрике, где DISM /Resetbase требуется более 30 минут.

Совет

Чтобы определить, когда параметр /ResetBase был последним запуском, проверьте запись реестра LastResetBase_UTC в пути к реестру HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing .

Синтаксис

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Параметр Описание
/RevertPendingActions При сбое загрузки можно использовать параметр /RevertPendingActions, чтобы попытаться восстановить систему. Операция отменяет все ожидающие действия из предыдущих операций обслуживания, так как эти действия могут быть причиной сбоя загрузки. Параметр /RevertPendingActions не поддерживается в работающей операционной системе или образе среды восстановления Windows или Среды восстановления Windows (Windows RE). Важно. Параметр /RevertPendingActions следует использовать только в сценарии восстановления системы на образе Windows, который не загрузил.
SpSuperseded Удаляет все файлы резервной копии, созданные во время установки пакета обновления. Используйте /HideSP, чтобы предотвратить перечисление пакета обновления в панель управления установленных обновлений. Пакет обновления нельзя удалить после завершения операции /SPSupersed.
/StartComponentCleanup Очищает заменяемые компоненты и уменьшает размер хранилища компонентов. Используйте /ResetBase для сброса базы замененных компонентов, что может дополнительно уменьшить размер хранилища компонентов. Установленные обновления Windows не могут быть удалены после запуска /StartComponentCleanup с параметром /ResetBase. Используйте /Defer с параметром /ResetBase, чтобы отложить длительные операции очистки до следующего автоматического обслуживания.
/AnalyzeComponentStore Создает отчет о хранилище компонентов. Дополнительные сведения об отчете и использовании сведений, предоставленных в отчете, см. в разделе "Определение фактического размера папки WinSxS".
/CheckHealth Проверяет, был ли образ помечен как поврежденный сбой процесса и можно ли исправить повреждение.
/ScanHealth Сканирует изображение для повреждения хранилища компонентов. Эта операция займет несколько минут.
/RestoreHealth Сканирует образ для повреждения хранилища компонентов, а затем выполняет операции восстановления автоматически. Эта операция займет несколько минут.
/Источник Используется с параметром /RestoreHealth, чтобы указать расположение известных хороших версий файлов, которые можно использовать для восстановления, например путь к каталогу Windows подключенного образа.
/LimitAccess Запрещает DISM обращаться к Обновл. 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

Дополнительные сведения см. в статье "Восстановление образа Windows".

Ограничения

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

Что такое DISM?

Параметры командной строки управления изображениями DISM

Параметры командной строки службы образов развертывания (DISM)