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, because 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)