NAME

       wimlib-imagex-delete - Delete an image from a WIM archive

SYNOPSIS

       wimlib-imagex delete WIMFILE IMAGE [OPTION...]

DESCRIPTION

       wimlib-imagex  delete  deletes  the  specified  image  from the Windows Imaging (WIM) file
       WIMFILE.  This command is also available as simply wimdelete if the appropriate hard  link
       or batch file has been installed.

       IMAGE specifies the WIM image in WIMFILE to delete.  It may be a 1-based index of an image
       in the WIM, the name of an image in the WIM, or the keyword "all"  to  indicate  that  all
       images  are  to  be deleted.  Use the wimlib-imagex info (1) command to show what images a
       WIM file contains.

NOTES

       By default, the WIM file is rebuilt 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.  (See the --soft option for the  other  kind  of
       delete).

       Also  wimlib  allows you to delete all the images from a WIM and have a WIM with 0 images,
       although such a file wouldn't be very useful.

       wimlib-imagex delete does not support split WIMs.

OPTIONS

       --check
             When reading WIMFILE, verify its  integrity  if  the  integrity  table  is  present;
             additionally,  when  rewriting WIMFILE after the specified image was deleted, always
             write an integrity table.  If this option is not specified, the integrity of WIMFILE
             will  not be checked when it's opened, but an integrity table will be written in the
             updated WIM if and only if one was present before.

       --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  streams
             will  be  left  alone,  even if they are no longer referenced.  This is probably not
             what you want, because no space will be saved by deleting an image in this way.

             You may use wimlib-imagex optimize to delete unreferenced streams from  a  WIM  that
             has had images soft-deleted from it.

       --unsafe-compact
             See the documentation for this option in wimlib-imagex-optimize (1).

EXAMPLES

       Delete the first image from 'boot.wim':

              wimlib-imagex delete boot.wim 1

SEE ALSO

       wimlib-imagex(1) wimlib-imagex-info(1) wimlib-imagex-optimize(1)