wimdelete

WIMDELETE(1) User Commands WIMDELETE(1)

NAME

   wimdelete - Delete an image from a WIM archive

SYNOPSIS

   wimdelete WIMFILE IMAGE [OPTION...]

DESCRIPTION

   wimdelete, or equivalently wimlib-imagex delete, deletes the specified image from the Windows Imaging (WIM) archive WIMFILE.

   IMAGE specifies the WIM image in WIMFILE to delete.  It may be the 1-based index of an image, the name of an image, or the keyword "all" to specify all images.  You can use wiminfo(1)
   to list the images contained in WIMFILE.

NOTES

   By  default, wimdelete rebuilds the WIM with all unnecessary file data removed.  This is different from Microsoft's ImageX and DISM, which only will delete the directory tree metadata
   and XML data for this operation.  Use --soft if you want the other kind of delete.

   wimlib allows you to delete all the images from a WIM and have a WIM with 0 images, although such a file may not be very useful.

   wimdelete does not support split WIMs.

OPTIONS

   --check
         Before deleting the image, verify the WIM's integrity if extra integrity information is present.  In addition, include extra integrity information in the modified WIM,  even  if
         it was not present before.

   --include-integrity
         Include extra integrity information in the modified WIM, i.e. like --check but don't do any verification beforehand.

   --soft
         Perform  a  "soft delete".  Specifying this flag overrides the default behavior of rebuilding the entire WIM after deleting an image.  Instead, only minimal changes to correctly
         remove the image from the WIM will be taken.  In particular, all file resources will be left alone, even if they are no longer referenced.  This may not be what  you  want,  be
         cause no space will be saved by deleting an image in this way.  However, wimoptimize can later be used to rebuild a WIM file that has had images soft-deleted from it.

   --unsafe-compact
         Compact  the WIM archive in-place, eliminating "holes".  This is efficient, but in general this option should not be used because a failed or interrupted compaction will corrupt
         the WIM archive.  For more information, see the documentation for this option to wimoptimize(1).

EXAMPLES

   Delete the first image from 'boot.wim':

          wimdelete boot.wim 1

SEE ALSO

   wimlib-imagex(1) wiminfo(1) wimoptimize(1)

wimlib 1.14.4 February 2024 WIMDELETE(1)