.TH MKWINPEIMG "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
mkwinpeimg \- ساخت یک ایمیج قابل بوت سفارشی‌شده از Windows PE
.SH "خلاصه دستور (SYNOPSIS)"
.B mkwinpeimg
[\fIOPTIONS\fR] \fIIMAGE\fR
.SH "توضیحات (DESCRIPTION)"
ابزار \fBmkwinpeimg\fR قادر است با استفاده از فایل‌های برگرفته از یک ایمیج ISO مانت‌شدهٔ نصب ویندوز (Vista یا جدیدتر) یا ایمیج ISO مانت‌شدهٔ مجموعهٔ Windows Automated Installation Kit (WAIK) یا مکمل WAIK، یک ایمیج قابل بوت از Windows PE بسازد. گزینه‌های \fB\-\-windows\-dir\fR و \fB\-\-waik\-dir\fR برای مشخص کردن مسیر این ISOهای مانت‌شده به‌کار می‌روند. تنها به مشخص کردن یکی از این دو نیاز است. فایل‌هایی که \fBmkwinpeimg\fR استخراج می‌کند شامل \fIboot.wim\fR، \fIbootmgr\fR، \fIboot.sdi\fR و \fIbcd\fR هستند. در صورت ساخت ایمیج ISO، فایل \fIetfsboot.com\fR نیز استخراج می‌شود. حقوق مالکیت این فایل‌ها متعلق به مایکروسافت است و همراه با wimlib توزیع نمی‌شوند.
.PP
\fBmkwinpeimg\fR می‌تواند دو نوع ایمیج قابل بوت بسازد. حالت پیش‌فرض، ساخت یک ایمیج دیسک قابل بوت است. این ایمیج پارتیشن‌بندی نشده و با فایل‌سیستم FAT قالب‌بندی (format) می‌شود. برای ساخت این نوع ایمیج، ابزار \fBsyslinux\fR(1) مورد نیاز است، زیرا برای بارگذاری زنجیره‌ای (chainload) فایل \fIbootmgr\fR استفاده می‌شود. همچنین به \fBmtools\fR(1) نیاز است تا فایل‌سیستم FAT بدون نیاز به دسترسی‌های مدیر سیستم (root) ساخته شود.
.PP
نوع دیگر ایمیج قابل بوت که \fBmkwinpeimg\fR می‌تواند بسازد، ایمیج ISO قابل بوت است. برای ساخت این نوع ایمیج، گزینهٔ \fB\-\-iso\fR را مشخص کنید. برای ساخت این نوع ایمیج به \fBmkisofs\fR(1) نیاز است. در حالت \fB\-\-iso\fR، می‌توانید \fIIMAGE\fR را به‌صورت "-" تعیین کنید تا ایمیج ISO در خروجی استاندارد نوشته شود.
.PP
در صورت ساخت ایمیج دیسک، می‌توانید آن را روی یک حافظهٔ فلش USB قرار دهید، و در صورت ساخت ایمیج ISO، می‌توانید آن را روی یک لوح فشرده (CD) بنویسید. علاوه بر این، هر دو نوع ایمیج را می‌توان با استفاده از ماژول MEMDISK توسط بوت‌لودرهای SYSLINUX یا PXELINUX بارگذاری کرد.
.PP
خودِ Windows PE درون فایل \fIboot.wim\fR قرار دارد. \fBmkwinpeimg\fR می‌تواند این فایل را پیش از گنجاندن در ایمیج قابل بوت ویرایش کند. کاربردی‌ترین تغییر، تعیین یک فایل اجرایی یا یک batch file است تا Windows PE بلافاصله پس از راه‌اندازی آن را اجرا کند. برای تعیین چنین فایلی از گزینهٔ \fB\-\-start\-script\fR \fIFILE\fR استفاده کنید. همچنین می‌توانید با قرار دادن فایل‌های دلخواه در یک دایرکتوری و مشخص کردن گزینهٔ \fB\-\-overlay\fR \fIDIR\fR، آنها را به \fIboot.wim\fR اضافه کنید. با این حال، برای اعمال تغییرات گسترده‌تر، پیشنهاد می‌شود فایل \fIboot.wim\fR را به‌طور جداگانه با \fBwimmountrw\fR(1) یا \fBwimupdate\fR(1) تغییر داده و سپس با استفاده از گزینهٔ \fB\-\-wim\fR آن را به \fBmkwinpeimg\fR معرفی کنید.
.PP
اگر گزینهٔ \fB\-\-only\-wim\fR داده شود، \fBmkwinpeimg\fR همچنین می‌تواند به‌جای ساخت ایمیج دیسک یا ISO قابل بوت، تنها یک فایل \fIboot.wim\fR اصلاح‌شده ایجاد کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 6
\fB\-i\fR، \fB\-\-iso\fR
ساخت یک ایمیج ISO به‌جای ایمیج دیسک.
.TP
\fB\-o\fR، \fB\-\-only\-wim\fR
عدم ساخت ایمیج دیسک یا ISO؛ در عوض، تنها یک فایل \fIboot.wim\fR اصلاح‌شده تولید شود.
.TP
\fB\-W\fR، \fB\-\-windows\-dir\fR=\fIDIR\fR
استفاده از DIR به‌عنوان مسیر ایمیج ISO مانت‌شدهٔ نصب ویندوز. اگر نه \fB\-\-windows\-dir\fR و نه \fB\-\-waik\-dir\fR مشخص نشده باشند، اسکریپت در مسیرهای پیش‌فرض زیر به دنبال ISO مانت‌شده می‌گردد:
/mnt/windows، /mnt/windows7، /mnt/windows8، و /mnt/windows10.
.TP
\fB\-A\fR، \fB\-\-waik\-dir\fR=\fIDIR\fR
دریافت فایل‌های بوت و boot.wim از ISO مانت‌شدهٔ Windows Automated Installation Kit در DIR به‌جای ISO نصب ویندوز. این گزینه در صورتی که ISO مانت‌شده مربوط به مکمل WAIK باشد (به‌جای خودِ WAIK) نیز کار می‌کند.
.TP
\fB\-s\fR، \fB\-\-start\-script\fR=\fIFILE\fR
افزودن FILE به دایرکتوری ریشهٔ ایمیج Windows PE و تغییر \eWindows\eSystem32\ewinpeshl.ini برای اجرای FILE در زمان راه‌اندازی Windows PE.
.TP
\fB\-w\fR، \fB\-\-wim\fR=\fIWIM\fR
استفاده از WIM به‌عنوان فایل "boot.wim". پیش‌فرض، فایل WIM مناسب برگرفته از ISO ویندوز، WAIK یا مکمل WAIK است.
.TP
\fB\-O\fR، \fB\-\-overlay\fR=\fIDIR\fR
افزودن تمام فایل‌های موجود در دایرکتوری DIR به ایمیج Windows PE.
.TP
\fB\-t\fR، \fB\-\-tmp\-dir\fR=\fIDIR\fR
استفاده از DIR برای ذخیرهٔ فایل‌های موقت. پیش‌فرض، دایرکتوری ایجادشده با استفاده از "mktemp -d" است.
.TP
\fB\-a\fR، \fB\-\-arch\fR=\fIARCH\fR
استفاده از نسخهٔ Windows PE برگرفته از Windows Automated Installation Kit (یا مکمل WAIK) با معماری پردازندهٔ \fIARCH\fR. تنها همراه با \fB\-\-waik\-dir\fR معتبر است. مقادیر ممکن: "x86" یا "amd64". پیش‌فرض "x86" است.
نکته: WAIK همچنین شامل ایمیج Windows PE برای معماری ia64 (ایتانیوم) است؛ هرچند این معماری توسط این اسکریپت پشتیبانی نمی‌شود.
.TP
\fB\-h\fR، \fB\-\-help\fR
نمایش پیام راهنما.
.TP
\fB\-v\fR، \fB\-\-version\fR
نمایش اطلاعات نسخه.
.SH "مثال‌ها (EXAMPLES)"
ساخت یک ایمیج دیسک قابل بوت از Windows PE با استفاده از رسانهٔ نصب ویندوز (Vista یا جدیدتر) مانت‌شده در /media/windows:
.RS
.PP
mkwinpeimg --windows-dir=/media/windows winpe.img
.RE
.PP
ساخت یک ISO قابل بوت از Windows PE با استفاده از WAIK (یا مکمل WAIK) مانت‌شده در /media/waik، و افزودن تمامی فایل‌های پوشهٔ "winpe_overlay" به فایل‌سیستم Windows PE:
.RS
.PP
mkwinpeimg --iso --waik-dir=/media/waik --overlay=winpe_overlay winpe.iso
.RE
.PP
ساخت یک ایمیج قابل بوت از Windows PE با استفاده از رسانهٔ نصب ویندوز مانت‌شده در /media/windows، افزودن "install.cmd" و اجرای خودکار آن هنگام راه‌اندازی. در این مثال، ایمیج برای راه‌اندازی تحت شبکه در دایرکتوری ریشهٔ کارساز TFTP ایجاد می‌شود:
.RS
.PP
mkwinpeimg --start-script=install.cmd --windows-dir=/media/windows /var/tftpboot/winpe.img
.RE
.PP
.SH "نکات (NOTES)"
مجوزهای مایکروسافت ممکن است اهداف استفاده از Windows PE را محدود کنند، و ممکن است حقوق شما را برای توزیع مجدد نسخه‌های سفارشی‌شدهٔ Windows PE محدود سازند.
.SH "گزارش باگ‌ها (BUGS)"
گزارش اشکالات را به آدرس \fIhttps://wimlib.net/forums\fR ارسال کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)