При восстановлении хранилища компонентов Windows 11 или Windows 10 с помощью команд DISM некоторые пользователи могут столкнуться с ошибкой: Неизвестный параметр Cleanup-Image, хотя команды вводятся верно и без ошибок.
В этой инструкции подробно о том, чем вызвана ошибка и что делать, чтобы выполнить нужные действия. На близкую тему по другим ошибкам с тем же кодом: Ошибка 87 при использовании команд DISM — причины и решения.
Почему не работает параметр Cleanup-Image в DISM и как это исправить
В большинстве случаев ошибка «Неизвестный параметр Cleanup-Image» во время выполнения команд DISM возникает при сочетании следующих двух условий:
- Команды выполняются в командной строке в среде восстановления или с загрузочной флешки
- В команде параметром /Online указано обращение к рабочему образу системы
Работая в среде восстановления пользователь не может выполнять привычные операции, такие как DISM /Online /Cleanup-Image /RestoreHealth, поскольку они предполагают запуск и действия над образом системы, который в настоящий момент находится в рабочем состоянии, то есть предназначен для работы в запущенной ОС. Отсюда и ошибка, сообщающая о недоступности параметра.
Если вы откроете справку по доступным параметрам с помощью команды dism /online /? вы сможете увидеть, что параметр Cleanup-Image доступен при выполнении указанной команды в запущенной Windows и отсутствует при использовании среды восстановления — список поддерживаемых параметров отличается, в зависимости от обслуживаемого образа и его состояния.
Однако, выполнить нужные задачи над образом системы (хранилищем компонентов) вомзожно. Вы поступить одним из следующих способов:
- Если возможен запуск Windows в безопасном режиме, использовать обычные команды восстановления в безопасном режиме — они будут работать.
- Проводить операции над оффлайн-образом. Пример команды для проверки образа:
dism /Image:C /Cleanup-Image /ScanHealth
Восстановление образа потребует указания источника для восстановления, примеры можно найти в этой инструкции (написана для Windows 11, но подойдет и для Windows 10).
- Вы можете использовать WinPE для восстановления хранилища компонентов и системных файлов.
Надеюсь, инструкция помогла разобраться в причинах ошибки, решить проблему и выполнить нужные действия по восстановлению образа системы и целостности системных файлов Windows.
В этой публикации, друзья, рассмотрим ошибку «Неизвестный параметр Cleanup-Image», возникающую при работе с консольным средством Dism в процессе восстановления повреждённого хранилища компонентов Windows, что обычно нужно для восстановления целостности системных файлов Windows. Т.е. когда мы используем команды Dism /Online /Cleanup-Image /ScanHealth или Dism/Online /Cleanup-Image /RestoreHealth. Эта ошибка означает, что мы используем неправильный или неподдерживаемый параметр для команды Dism. Из-за чего возникает эта ошибка, и как её исправить?
Элементарная причина рассматриваемой ошибки Dism — ошибки в написании команд. Ошибки в словах или синтаксисе команды, ошибки в пути к источнику образа.
Основная причина ошибки «Неизвестный параметр Cleanup-Image» заключается в том, что мы пытаемся выполнить команду Dism с параметром /Online, когда находимся в среде восстановления Windows или в среде WinPE с загрузочной флешки. Параметр /Online предусматривает обращение к образу работающей Windows. Его нельзя использовать в среде восстановления или WinPE. Решения в этой ситуации могут быть разные:
- Выполнение команды Dism с параметром /Online в условиях запуска Windows в безопасном режиме, если операционная система может запуститься в этом режиме;
- Восстановление целостности системных файлов в автономном режиме;
- Использование программы Dism++ на борту WinPE 11-10-8 Sergei Strelec.
Ещё, друзья, имейте в виду, что вообще восстановить системные файлы Windows можно не только консольным средством SFC.exe, но также путём обновления Windows с помощью ISO-образа или установочного носителя её текущей версии.
Ошибка «Неизвестный параметр Cleanup-Image» может возникать, если мы указываем не тот образ Windows в качестве источника восстановления хранилища. Если мы восстанавливаем Windows 10, источником должен быть образ Windows 10. Если восстанавливаем Windows 11, источником должен быть образ Windows 11. Если восстанавливаем, например, Windows 11 в редакции Pro, источником должен быть образ Windows 11 Pro. Если восстанавливаем, например, Windows 11 версии 23H2, образ должен быть Windows 11 23H2. Смотрим:
- Как узнать версию Windows в работающей системе;
- Как узнать версию Windows, если система не запускается.
Не тем образом Windows, из-за чего возникает рассматриваемая ошибка, может быть повреждённый образ. Скачиваем новый чистый образ установки Windows.
Друзья, рассматриваемая ошибка может сопровождаться кодом 87. Смотрите о причинах ошибки 87 при работе с Dism.
Learn how to resolve the DISM error 87 cleanup-image option is unknown issue on Windows 10 and 11 with detailed solutions and troubleshooting tips.
Encountering DISM Error 87 with the message “The cleanup-image option is unknown” is a common issue for Windows users, especially when running the DISM /Online /Cleanup-Image commands. This error can disrupt your attempts to repair or restore a corrupted system image. Whether you’re on Windows 10 or Windows 11, this comprehensive guide will walk you through why this error occurs and how to fix it.
What Is DISM, and Why Is It Important?
DISM, or Deployment Image Servicing and Management, is a Windows command-line tool designed to repair and manage system images. It is widely used to fix corrupted system files, perform maintenance tasks, or prepare Windows images for deployment. However, incorrect usage of the tool can result in errors such as “Error 87: The cleanup-image option is unknown.”
This particular issue arises when users try to execute commands like:
cmdCopy codeDism /Online /Cleanup-Image /ScanHealth
Dism /Online /Cleanup-Image /RestoreHealth
Instead of running successfully, the tool returns an error, making it impossible to proceed with system repairs.
Common Scenarios of DISM Error 87
Many users report that while running DISM /Online /Cleanup-Image /ScanHealth, they receive the message:
“Error 87: The cleanup-image option is unknown.”
Here are some real-life situations where this error occurs:
- The command
DISM /Online /Cleanup-Image /ScanHealth
fails, butDISM /Online /Cleanup-Image /?
works fine, showing the appropriate help information. - On attempting
sfc /scannow
, it either works without issues or fails with “Windows Resource Protection could not start the repair service.” - Errors appear on both Windows 10 and Windows 11, with no clear indication of the root cause.
Why Does the Cleanup-Image Option Return Error 87?
Several factors contribute to “The cleanup-image option is unknown” error in DISM:
- Incorrect Command Syntax: The most common cause of DISM errors is improperly formatted commands. For instance, missing spaces between parameters or options like
/Online
and/Cleanup-Image
can lead to the “Error 87” message. - Lack of Administrator Privileges: Running DISM without administrative rights can cause issues, including the “cleanup-image option is unknown” error.
- Windows Version Compatibility Issues: Some DISM commands are not supported by outdated Windows versions. For example, a Windows 10-specific command may not work on older builds or improperly updated versions of Windows 11.
- Corrupted System Image or DISM Tool: If the DISM tool itself is corrupted or the system image is damaged, commands may fail to execute correctly.
1. Correct the Command Syntax
Incorrect syntax is the primary reason for DISM cleanup-image option is unknown errors. For example:
- Incorrect:
Dism /Online/Cleanup-Image/ScanHealth
- Correct:
Dism /Online /Cleanup-Image /ScanHealth
Ensure there are spaces between /Online
, /Cleanup-Image
, and /ScanHealth
. Double-check your input before pressing Enter.
For detailed guidance, refer to Microsoft’s official documentation: DISM Command-Line Options.
2. Run Command Prompt as Administrator
Lack of administrative privileges is another common issue behind the DISM error 87 the cleanup image option is unknown message. Follow these steps to run CMD as Administrator:
- Press Win + S and type cmd.
- Right-click on Command Prompt and select Run as Administrator.
- Retry the command with the correct syntax:cmdCopy code
DISM /Online /Cleanup-Image /ScanHealth
3. Update Your Windows Version
Outdated Windows versions often lack the necessary support for certain DISM commands. To resolve this:
- Navigate to Settings > Update & Security > Windows Update.
- Click Check for Updates and install any pending updates.
- Restart your system and retry the DISM command.
If you’re running Windows 11, ensure your build is updated to the latest version, as newer commands may not work on older builds.
For more information on version-specific DISM commands, visit: DISM Error 87 for Windows 10.
4. Use the Full DISM Path
Sometimes, specifying the full path of the DISM executable resolves errors:
cmdCopy codeC:\Windows\System32\Dism.exe /Online /Cleanup-Image /ScanHealth
This ensures that the system uses the correct tool for executing the command.
5. Check for Corrupted System Files
If sfc /scannow
returns “Windows Resource Protection could not start the repair service”, you need to ensure that the Windows Modules Installer service is running:
- Press Win + R, type
services.msc
, and hit Enter. - Find Windows Modules Installer, right-click it, and select Start.
- Run the command again:cmdCopy code
sfc /scannow
If the system file checker still fails, proceed to offline repair.
6. Perform an Offline Repair
If the online DISM repair fails, you can use a Windows installation image for an offline repair:
cmdCopy codeDISM /Online /Cleanup-Image /RestoreHealth /Source:WIM:X:\Sources\Install.wim:1 /LimitAccess
Replace X with the drive letter of your installation media. This method bypasses issues caused by online corruption.
7. Reinstall or Repair the DISM Tool
In rare cases, the DISM tool itself may be corrupted. Use the following steps to reinstall or repair it:
- Download the latest version of DISM for your Windows version from Microsoft’s website.
- Replace the existing DISM executable in
C:\Windows\System32
with the new version. - Retry the cleanup-image command.
How to Prevent DISM Errors in the Future
To avoid encountering the DISM error 87 cleanup image option is unknown issue again:
- Keep Your System Updated: Regular updates ensure compatibility with all Windows utilities.
- Follow Correct Syntax: Always double-check your commands before executing them.
- Run Commands with Administrator Privileges: This avoids unnecessary permission-related errors.
Conclusion
The DISM error 87 the cleanup-image option is unknown is a common yet solvable issue for both Windows 10 and Windows 11 users. By ensuring correct syntax, updating your system, and running commands as an administrator, you can easily fix this problem. For more advanced issues, offline repairs or replacing the DISM tool might be necessary.
Visit Our Post Page: Blog Page
Чем асинхронная логика (схемотехника) лучше тактируемой, как я думаю, что помимо энергоэффективности — ещё и безопасность.
Hrethgir 14.05.2025
Помимо огромного плюса в энергоэффективности, асинхронная логика — тотальный контроль над каждым совершённым тактом, а значит — безусловная безопасность, где безконтрольно не совершится ни одного. . .
Многопоточные приложения на C++
bytestream 14.05.2025
C++ всегда был языком, тесно работающим с железом, и потому особеннно эффективным для многопоточного программирования. Стандарт C++11 произвёл революцию, добавив в язык нативную поддержку потоков,. . .
Stack, Queue и Hashtable в C#
UnmanagedCoder 14.05.2025
Каждый опытный разработчик наверняка сталкивался с ситуацией, когда невинный на первый взгляд List<T> превращался в узкое горлышко всего приложения. Причина проста: универсальность – это прекрасно,. . .
Как использовать OAuth2 со Spring Security в Java
Javaican 14.05.2025
Протокол OAuth2 часто путают с механизмами аутентификации, хотя по сути это протокол авторизации. Представьте, что вместо передачи ключей от всего дома вашему другу, который пришёл полить цветы, вы. . .
Анализ текста на Python с NLTK и Spacy
AI_Generated 14.05.2025
NLTK, старожил в мире обработки естественного языка на Python, содержит богатейшую коллекцию алгоритмов и готовых моделей. Эта библиотека отлично подходит для образовательных целей и. . .
Реализация DI в PHP
Jason-Webb 13.05.2025
Когда я начинал писать свой первый крупный PHP-проект, моя архитектура напоминала запутаный клубок спагетти. Классы создавали другие классы внутри себя, зависимости жостко прописывались в коде, а о. . .
Обработка изображений в реальном времени на C# с OpenCV
stackOverflow 13.05.2025
Объединение библиотеки компьютерного зрения OpenCV с современным языком программирования C# создаёт симбиоз, который открывает доступ к впечатляющему набору возможностей. Ключевое преимущество этого. . .
POCO, ACE, Loki и другие продвинутые C++ библиотеки
NullReferenced 13.05.2025
В C++ разработки существует такое обилие библиотек, что порой кажется, будто ты заблудился в дремучем лесу. И среди этого многообразия POCO (Portable Components) – как маяк для тех, кто ищет. . .
Паттерны проектирования GoF на C#
UnmanagedCoder 13.05.2025
Вы наверняка сталкивались с ситуациями, когда код разрастается до неприличных размеров, а его поддержка становится настоящим испытанием. Именно в такие моменты на помощь приходят паттерны Gang of. . .
Создаем CLI приложение на Python с Prompt Toolkit
py-thonny 13.05.2025
Современные командные интерфейсы давно перестали быть черно-белыми текстовыми программами, которые многие помнят по старым операционным системам. CLI сегодня – это мощные, интуитивные и даже. . .
Консольная утилита DISM используется не только для работы с дисками и разделами, ее возможности также включают установку/удаление/обновление пакетов системных компонентов, интеграция драйверов в образ Windows, монтирование/размонтирование образов, а также проверку и восстановление целостности образа Windows. К этой последней операции нередко приходится прибегать, когда sfc /scannow выдает ошибку защиты ресурсов Windows.
Или требует восстановления хранилища.
Но и здесь вас может ждать сюрприз – ошибка 87 «Неизвестный параметр Cleanup-Image» или ошибка 50 «Средство Dism не поддерживает обслуживание среды предустановки…» при том что опечатки в наборе команды не было.
Так бывает, когда работая в среде WinPE или WinRE, пользователь использует традиционный синтаксис команды проверки или восстановления хранилища, например, вот так:
dism /online /cleanup-image /restorehealth
Это хорошо известна многим пользователям команда восстановления хранилища компонентов Windows, но в загрузочной среде она работать не будет, поскольку образ Windows не подключен и находится в неактивном состоянии. Кроме того, набор доступных параметров обслуживания хранилища компонентов в работающей системе и в среде восстановления будет отличаться.
Тем не менее, выполнить обслуживание хранилища средствами Dism в среде восстановления можно.
Для этого вам понадобится флешка с записанной на нее Windows или распакованный на жестком диске установочный образ с той же Windows. Если образ содержит несколько редакций системы, а вам нужна, к примеру, Pro, сначала нужно узнать номер этой редакции.
Для этого в загрузочной среде выполните следующую команду:
dism /Get-WimInfo /WimFile:путь-к-файлу-install.esd или wim
Определив индекс редакции, а он должен быть совпадать с редакцией системы, в которой выполняется восстановление образа, выполните следующую команду:
dism /image:c:\ /cleanup-image /restorehealth /source:путь-к-файлу-install.esd:индекс
C в данном примере это буква раздела, на котором находятся файлы Windows, от примера к примеру она может отличаться, поэтому перед выполнением команды не забудьте ее определить, выведя список томов командой list volume в той же diskpart.