.TH WIMUPDATE "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
wimupdate \- به‌روزرسانی یک تصویر WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimupdate\fR \fIWIMFILE\fR [\fIIMAGE\fR] [\fIOPTION\fR...] [< \fICMDFILE\fR]
.SH "توضیحات (DESCRIPTION)"
دستور \fBwimupdate\fR، یا معادل آن \fBwimlib-imagex update\fR، تصویر مشخص‌شدهٔ \fIIMAGE\fR را در بایگانی Windows Imaging (WIM) به نام \fIWIMFILE\fR با افزودن، حذف یا تغییر نام فایل‌ها یا دایرکتوری‌ها در آن اصلاح می‌کند.
.PP
آرگومان \fIIMAGE\fR تصویری را در \fIWIMFILE\fR مشخص می‌کند که باید به‌روزرسانی شود. این مقدار می‌تواند نمایهٔ مبتنی بر ۱ تصویر یا نام آن باشد. اگر \fIWIMFILE\fR تنها شامل یک تصویر باشد، می‌توان این آرگومان را نادیده گرفت. برای فهرست کردن تصاویر موجود در \fIWIMFILE\fR می‌توانید از \fBwiminfo\fR(1) استفاده کنید.
.PP
تغییراتی که باید روی تصویر WIM انجام شوند به صورت توالی‌ای از دستورها، یک دستور در هر خط، از یک فایل متنی (با کدگذاری UTF-8 یا UTF-16LE؛ اسکی ساده نیز قابل قبول است) از ورودی استاندارد خوانده می‌شوند. توصیه می‌شود ورودی استاندارد همان‌طور که در بالا نشان داده شده است از یک فایل (\fICMDFILE\fR) تغییر مسیر داده شود، نه اینکه دستورها به صورت تعاملی تایپ شوند. در غیر این صورت، برای تعیین مستقیم یک دستور در خط فرمان، گزینهٔ \fB--command\fR را ببینید.
.SH "دستورهای موجود (AVAILABLE COMMANDS)"
این بخش دستورهایی را که ممکن است در \fICMDFILE\fR شرح‌داده‌شده در بالا ظاهر شوند، مستند می‌کند.
.SS \fBadd\fR [\fIOPTION\fR...] \fISOURCE\fR \fIDESTINATION\fR
افزودن یک فایل یا درخت دایرکتوری به تصویر WIM. مقدار \fISOURCE\fR باید مسیر یک فایل یا دایرکتوری را در سیستم‌فایل شما مشخص کند. مقدار \fIDESTINATION\fR باید مسیری را درون تصویر WIM مشخص کند که فایل یا درخت دایرکتوری باید در آن افزوده شود.
.PP
اگر \fIDESTINATION\fR نام یک دایرکتوری موجود در تصویر WIM باشد، \fISOURCE\fR نیز باید نام یک دایرکتوری باشد. این امر باعث می‌شود که محتویات دایرکتوری \fISOURCE\fR به دایرکتوری \fIDESTINATION\fR افزوده شود.
.PP
اگر \fIDESTINATION\fR نام یک فایل غیردایرکتوری موجود در تصویر WIM باشد، \fISOURCE\fR نیز باید نام یک فایل غیردایرکتوری باشد. به طور پیش‌فرض، این کار باعث می‌شود فایل \fIDESTINATION\fR با فایل \fISOURCE\fR جایگزین شود؛ یا در صورت تعیین \fB--no-replace\fR، این عمل یک خطا ایجاد می‌کند.
.PP
اگر \fIDESTINATION\fR در تصویر WIM وجود نداشته باشد، تمام دایرکتوری‌های پیش‌نیاز در صورت لزوم برای افزودن \fISOURCE\fR در آن مکان ایجاد می‌شوند.
.PP
دستور \fBadd\fR از زیرمجموعه‌ای از گزینه‌های پذیرفته‌شده توسط \fBwimcapture\fR پشتیبانی می‌کند؛ به‌ویژه \fB--dereference\fR، \fB--unix-data\fR، \fB--no-acls\fR و \fB--strict-acls\fR. برای توضیحات این گزینه‌ها \fBwimcapture\fR(1) را ببینید.
.PP
علاوه بر این، دستور \fBadd\fR از گزینهٔ \fB--no-replace\fR پشتیبانی می‌کند که باعث می‌شود دستور \fBadd\fR از بازنویسی فایل‌های غیردایرکتوری موجود در تصویر WIM خودداری کند.
.SS \fBdelete\fR [\fIOPTION\fR...] \fIPATH\fR
حذف یک فایل یا درخت دایرکتوری از تصویر WIM. مقدار \fIPATH\fR باید مسیر فایل یا درخت دایرکتوری مورد نظر برای حذف را درون تصویر WIM مشخص کند.
.PP
گزینه‌های موجود برای دستور \fBdelete\fR عبارتند از:
.TP 6
\fB--force\fR
اگر مسیر مورد نظر برای حذف وجود نداشته باشد، خطایی صادر نشود.
.TP
\fB--recursive\fR
حذف فایل یا درخت دایرکتوری به صورت بازگشتی؛ در صورت عدم تعیین، اگر مسیر مورد نظر برای حذف یک دایرکتوری باشد، خطا صادر می‌شود.
.SS \fBrename\fR \fIOLD_PATH\fR \fINEW_PATH\fR
تغییر نام یک فایل یا درخت دایرکتوری درون تصویر WIM. مقدار \fIOLD_PATH\fR باید مسیر قبلی فایل یا درخت دایرکتوری درون تصویر WIM را مشخص کند و \fINEW_PATH\fR باید مسیر جدید را برای فایل یا درخت دایرکتوری مشخص نماید. این دستور از معناشناسی تابع \fBrename\fR (3) در POSIX پیروی می‌کند؛ به‌ویژه، اگر فایلی از پیش در \fINEW_PATH\fR وجود داشته باشد حذف خواهد شد، مگر در موارد خاصی مانند تلاش برای تغییر نام یک دایرکتوری به یک غیردایرکتوری که مجاز نیست.
.PP
هیچ گزینه‌ای برای دستور \fBrename\fR وجود ندارد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر در خط فرمان توسط خود \fBwimupdate\fR پذیرفته می‌شوند:
.TP 6
\fB--dereference\fR
استفاده از \fB--dereference\fR برای تمام دستورهای \fBadd\fR.
.TP
\fB--unix-data\fR
استفاده از \fB--unix-data\fR برای تمام دستورهای \fBadd\fR.
.TP
\fB--no-acls\fR
استفاده از \fB--no-acls\fR برای تمام دستورهای \fBadd\fR.
.TP
\fB--strict-acls\fR
استفاده از \fB--strict-acls\fR برای تمام دستورهای \fBadd\fR.
.TP
\fB--no-replace\fR
استفاده از \fB--no-replace\fR برای تمام دستورهای \fBadd\fR.
.TP
\fB--config\fR=\fIFILE\fR
تنظیم فایل پیکربندی ضبط برای تمام دستورهای \fBadd\fR. توضیحات این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--force\fR
استفاده از \fB--force\fR برای تمام دستورهای \fBdelete\fR.
.TP
\fB--recursive\fR
استفاده از \fB--recursive\fR برای تمام دستورهای \fBdelete\fR.
.TP
\fB--check\fR
پیش از به‌روزرسانی WIM، در صورتی که حاوی اطلاعات یکپارچگی اضافی باشد، صحت آن را بررسی می‌کند. همچنین اطلاعات یکپارچگی اضافی را در WIM به‌روزشده می‌گنجاند، حتی اگر قبلاً وجود نداشته باشد.
.TP
\fB--include-integrity\fR
گنجاندن اطلاعات یکپارچگی اضافی در WIM به‌روزشده؛ یعنی مانند \fB--check\fR اما بدون بررسی صحت WIM از پیش.
.TP
\fB--threads\fR=\fINUM_THREADS\fR
تعداد ریسه‌های مورد استفاده برای فشرده‌سازی فایل‌های تازه اضافه‌شده. پیش‌فرض: تشخیص خودکار (تعداد پردازنده‌ها).
.TP
\fB--rebuild\fR
بازسازی کل WIM به جای پیوست کردن داده‌های به‌روزشده به انتهای آن. بازسازی WIM کندتر است، اما مقدار کمی فضا صرفه‌جویی می‌کند که در غیر این صورت به عنوان یک حفره در فایل WIM باقی می‌ماند.
.IP
برای روشی با قابلیت سفارشی‌سازی بیشتر جهت بازسازی (و در صورت تمایل فشرده‌سازی مجدد) یک فایل WIM، \fBwimoptimize\fR(1) را ببینید. در صورت اجرای \fBwimoptimize\fR پس از \fBwimupdate\fR، نیازی به مشخص کردن \fB--rebuild\fR برای \fBwimupdate\fR نیست.
.TP
\fB--command\fR=\fISTRING\fR
به جای خواندن دستورهای به‌روزرسانی از ورودی استاندارد، یک دستور به‌روزرسانی منفرد را مستقیماً از رشتهٔ \fISTRING\fR مشخص‌شده در خط فرمان می‌خواند. این گزینه را نمی‌توان بیش از یک بار مشخص کرد و نمی‌توان از آن برای تعیین بیش از یک دستور به‌روزرسانی استفاده نمود. توجه داشته باشید که \fISTRING\fR و همچنین هر مسیری درون \fISTRING\fR که شامل فاصله است باید به درستی در علامت نقل‌قول (کوتیشن) قرار گیرند. در صورت اجرا از cmd.exe در ویندوز، باید از گیومه دوتایی (double quotes) برای نقل‌قول بیرونی و گیومه تکی (single quotes) برای نقل‌قول درونی استفاده کنید. مثال:
.IP
.RS
.RS
wimupdate boot.wim 1 --command="add 'C:\\My Dir' '\\My Dir'"
.RE
.RE
.IP
این گزینه صرفاً برای سهولت ارائه شده است. دستور \fBwimupdate\fR را چندین بار پشت‌سرهم با ارسال گزینهٔ \fB--command\fR در هر بار اجرا نکنید! این کار ناکارآمد است. در عوض، همان‌طور که در این سند توضیح داده شده است، یک فایل دستورهای به‌روزرسانی ایجاد کنید و آن را (از طریق ورودی استاندارد) به یک فراخوانی منفرد از \fBwimupdate\fR تحویل دهید.
.TP
\fB--wimboot-config\fR=\fIFILE\fR
در صورت مشخص شدن این گزینه، هیچ دستوری از ورودی استاندارد خوانده نخواهد شد و به جای آن دستور زیر اجرا می‌شود:
.IP
.nf
.RS
.RS
\fBadd\fR \fIFILE\fR /Windows/System32/WimBootCompress.ini
.RE
.RE
.fi
.IP
این گزینه \fIFILE\fR را به عنوان فایل پیکربندی WIMBoot برای تصویر تنظیم می‌کند. بخش [PrepopulateList] در این فایل، الگوهای مسیر را مشخص می‌کند که نباید به عنوان فایل‌های اشاره‌گر WIMBoot استخراج شوند (احتمالاً به دلیل نیاز داشتن به آن‌ها در مراحل اولیه فرایند راه‌اندازی/بوت). برای اطلاعات بیشتر به مستندات مربوط به گزینهٔ \fB--wimboot\fR در \fBwimapply\fR(1) مراجعه کنید.
.TP
\fB--unsafe-compact\fR
بایگانی WIM را درجا فشرده کرده و هرگونه دادهٔ جدید را پیوست می‌کند و «حفره‌ها» را از بین می‌برد. این کار کارآمد است، اما به‌طور کلی این گزینه \fIنباید\fR استفاده شود، زیرا فشرده‌سازی ناموفق یا قطع‌شده باعث خرابی بایگانی WIM خواهد شد. برای اطلاعات بیشتر، مستندات مربوط به این گزینه را در \fBwimoptimize\fR(1) ببینید.
.TP
\fB--ref\fR="\fIGLOB\fR"
الگوی فایلی (glob) مربوط به WIMهایی که WIM تفاضلی (delta WIM) بر پایهٔ آن‌ها استوار است. به‌روزرسانی WIMهای چندبخشی (split WIMs) مجاز نیست، اما به‌روزرسانی WIMهای تفاضلی مجاز است. هنگام به‌روزرسانی یک WIM تفاضلی، WIMهایی که WIM تفاضلی بر پایهٔ آن‌ها است باید با استفاده از این گزینه مشخص شوند. (این یک الزام قطعی نیست، اما برای کارکرد کامل حذف داده‌های تکراری و به‌روزرسانی صحیح آمار TOTALBYTES لازم است.)
.SH "نکات (NOTES)"
دستور \fBwimupdate\fR را می‌توان همپوشان با \fBwimmountrw\fR دانست، چرا که یک تصویر WIM را می‌توان با اتصال (mount) به صورت خواندن-نوشتن نیز به‌روزرسانی کرد. با این حال، \fBwimupdate\fR روی تمام پلتفرم‌ها از جمله ویندوز کار می‌کند، در حالی که \fBwimmountrw\fR تنها روی لینوکس کارایی دارد.
.PP
پیوندهای نمادین درون تصویر WIM هنگام تفسیر شدن ارجاع‌زدایی (dereference) نمی‌شوند. بنابراین، به عنوان مثال، اگر تصویر WIM شما حاوی یک پیوند نمادین به صورت "/Documents and Settings" -> "/Users" باشد که در آن "/Users" یک دایرکتوری است، یک زیردایرکتوری به نام "Public" در این دایرکتوری باید به صورت "/Users/Public" مشخص شود، نه "/Documents and Settings/Public".
.PP
تمام مسیرهای فایل‌ها یا دایرکتوری‌ها درون تصویر WIM باید نسبت به ریشهٔ تصویر مشخص شوند. با این حال، اسلش ابتدایی اختیاری است و هر دو اسلش رو به جلو (forward slash) و بک‌اسلش (backslash) پذیرفته می‌شوند. علاوه بر این، در ویندوز مسیرها به طور پیش‌فرض بدون حساسیت به حروف کوچک و بزرگ پردازش می‌شوند، در حالی که در سیستم‌های شبه‌یونیکس، مسیرها به حروف بزرگ و کوچک حساس هستند. حساسیت پیش‌فرض به حروف بزرگ و کوچک را می‌توان با تنظیم متغیر محیطی \fBWIMLIB_IMAGEX_IGNORE_CASE\fR روی 0 یا 1 تغییر داد.
.PP
فایل دستورها (\fICMDFILE\fR) توسط خود \fBwimupdate\fR تجزیه می‌شود و نه پوستهٔ سیستم. بنابراین، نحو آن محدود است. با این حال، خطوط توضیحی که با '#' شروع می‌شوند مجاز هستند، و همچنین نقل‌قول کردن آرگومان‌هایی که حاوی فاصله هستند ممکن است.
.PP
در سیستم‌های شبه‌یونیکس، نمی‌توانید از \fBwimupdate\fR برای افزودن مستقیم فایل‌ها به یک تصویر از یک حجم NTFS با استفاده از libntfs-3g استفاده کنید، اگرچه \fBwimcapture\fR از ضبط یک تصویر کامل به این روش پشتیبانی می‌کند.
.PP
به جز در هنگام استفاده از \fB--unsafe-compact\fR، متوقف کردن اجرای دستور \fBwimupdate\fR در میانهٔ راه بی‌خطر است؛ با این حال، پس از انجام این کار، توصیه می‌شود \fBwimoptimize\fR را اجرا کنید تا هر داده‌ای که به فایل فیزیکی WIM پیوست شده اما هنوز در ساختار WIM ادغام نشده است حذف شود، مگر اینکه \fB--rebuild\fR مشخص شده باشد که در این صورت باید فایل موقت باقی‌مانده را حذف کنید.
.SH "مثال‌ها (EXAMPLES)"
تمامی مثال‌های زیر، فایل دستورهای به‌روزرسانیِ مورد نیاز برای ایجاد و همچنین دستور \fBwimupdate\fR را که برای انجام به‌روزرسانی‌ها باید اجرا شود نشان می‌دهند.
.PP
حذف دو فایل از یک تصویر WIM:
.PP
.RS
\fIupdate_commands.txt\fR:
.RS
.PP
.nf
delete /setup.exe
delete /sources/setup.exe
.fi
.RE
.RE
.PP
.RS
$ wimupdate boot.wim 2 < update_commands.txt
.RE
.PP
افزودن چند فایل و دایرکتوری به یک تصویر WIM. توجه داشته باشید که مسیر اول در هر دستور \fBadd\fR فایل‌های مورد نظر برای افزودن را مشخص می‌کند، در حالی که مسیر دوم هر دستور \fBadd\fR مکان‌هایی را که باید این فایل‌ها درون تصویر WIM در آن‌ها اضافه شوند تعیین می‌نماید:
.PP
.RS
\fIupdate_commands.txt\fR:
.RS
.PP
.nf
add somedir     /dir
add somefile    /dir/file
.fi
.RE
.RE
.PP
.RS
$ wimupdate boot.wim 2 < update_commands.txt
.RE
.PP
تغییر نام یک فایل درون تصویر WIM:
.PP
.RS
\fIupdate_commands.txt\fR:
.RS
.PP
.nf
rename /dir_in_wim/oldfile.txt /dir_in_wim/newfile.txt
.fi
.RE
.RE
.PP
.RS
$ wimupdate boot.wim 2 < update_commands.txt
.RE
.PP
استفاده از قابلیت‌های بیشتر مانند توضیحات، گزینه‌ها و همپوشانی‌ها (overlays)، و گنجاندن اطلاعات یکپارچگی اضافی در WIM به‌روزشده:
.PP
.RS
\fIupdate_commands.txt\fR:
.RS
.PP
.nf
#
# این فایل برخی از تغییرات جهت اعمال روی یک تصویر WIM را مشخص می‌کند.
#

# افزودن یک دایرکتوری جدید شامل فایل‌هایی که می‌خواهم در تصویر باشند.
# استفاده از نقل‌قول‌ها لازم است زیرا نام دایرکتوری
# حاوی فاصله است.
add "My Directory" "/My Directory"

# افزودن محتویات "Another Directory" به
# "/My Directory" که تازه در تصویر WIM ایجاد کردیم. از آنجا که
# مسیر مقصد از قبل وجود دارد، این کار یک همپوشانی (overlay) انجام می‌دهد.
add "Another Directory" "/My Directory"

# تغییر نام یک فایل بنا به دلیلی.
rename /dir_in_wim/oldfile.txt /dir_in_wim/newfile.txt

# حذف یک دایرکتوری غیرضروری.
delete --recursive /Users/Me/Documents/Junk
.fi
.RE
.RE
.PP
.RS
$ wimupdate boot.wim 2 --check < update_commands.txt
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)
.BR wimcapture (1)
.BR wiminfo (1)
.BR wimmountrw (1)
.BR wimoptimize (1)