1WIMDELETE(1)                     User Commands                    WIMDELETE(1)
2
3
4

NAME

6       wimdelete - Delete an image from a WIM archive
7

SYNOPSIS

9       wimdelete WIMFILE IMAGE [OPTION...]
10

DESCRIPTION

12       wimdelete,  or equivalently wimlib-imagex delete, deletes the specified
13       image from the Windows Imaging (WIM) archive WIMFILE.
14
15       IMAGE specifies the WIM image in WIMFILE to  delete.   It  may  be  the
16       1-based  index  of an image, the name of an image, or the keyword "all"
17       to specify all images.  You can use wiminfo(1) to list the images  con‐
18       tained in WIMFILE.
19

NOTES

21       By  default,  wimdelete rebuilds the WIM with all unnecessary file data
22       removed.  This is different from Microsoft's  ImageX  and  DISM,  which
23       only  will delete the directory tree metadata and XML data for this op‐
24       eration.  Use --soft if you want the other kind of delete.
25
26       wimlib allows you to delete all the images from a WIM and  have  a  WIM
27       with 0 images, although such a file may not be very useful.
28
29       wimdelete does not support split WIMs.
30

OPTIONS

32       --check
33             Before  deleting  the  image, verify the WIM's integrity if extra
34             integrity information is present.  In addition, include extra in‐
35             tegrity  information  in  the  modified  WIM,  even if it was not
36             present before.
37
38       --include-integrity
39             Include extra integrity information in  the  modified  WIM,  i.e.
40             like --check but don't do any verification beforehand.
41
42       --soft
43             Perform  a "soft delete".  Specifying this flag overrides the de‐
44             fault behavior of rebuilding the entire WIM after deleting an im‐
45             age.  Instead, only minimal changes to correctly remove the image
46             from the WIM will be taken.  In particular,  all  file  resources
47             will  be left alone, even if they are no longer referenced.  This
48             may not be what you want, because  no  space  will  be  saved  by
49             deleting an image in this way.  However, wimoptimize can later be
50             used to rebuild a WIM file that has had images soft-deleted  from
51             it.
52
53       --unsafe-compact
54             Compact  the  WIM archive in-place, eliminating "holes".  This is
55             efficient, but in general this option should not be used  because
56             a  failed or interrupted compaction will corrupt the WIM archive.
57             For more information, see the documentation for  this  option  to
58             wimoptimize(1).
59

EXAMPLES

61       Delete the first image from 'boot.wim':
62
63              wimdelete boot.wim 1
64

SEE ALSO

66       wimlib-imagex(1) wiminfo(1) wimoptimize(1)
67
68
69
70wimlib 1.13.5                    December 2021                    WIMDELETE(1)
Impressum