خيارات وخصائص سطر أوامر برنامج الإعداد

عندما تقوم بتشغيل برنامج الإعداد، يمكنك استخدام خيارات سطر الأوامر لتغيير بعض المعلمات التي يستخدمها برنامج الإعداد لتثبيت التطبيق، مثل إعدادات العرض والقيم الافتراضية لخصائص برنامج الإعداد.

يستخدم برنامج الإعداد وWindows Installer الخصائص للتحكم بعمليات تثبيت التطبيقات. القيم الافتراضية لخصائص برنامج الإعداد محددة في حزمة Windows Installer (ملف MSI). يمكنك تعيين قيم خصائص جديدة على سطر الأوامر أو في ملف إعدادات برنامج التشغيل (Setup.ini).

ملاحظة   في أغلب الحالات، تتجاوز خيارات سطر الأوامر التخصيصات المكررة في ملف إعدادات برنامج الإعداد (Setup.ini) أو في ملف تحويل (MST). خيارات وخصائص سطر الأوامر غير معتمدة من قبل كافة ملفات MSI.

 

‎/a

‎/f

‎/i

‎/j

‎/l

‎/noreboot

‎/p

‎/q

‎/settings

‎/x

property=value

‎/?‎

 

‎/a [msifile]‎

قم بإنشاء نقطة تثبيت إداري للحزمة المعيّنة (ملف MSI). يجب أن تكون الحزمة في المجلد نفسه مثل Setup.exe، ويجب أن يكون كلاهما عند جذر نقطة التثبيت الإداري.

أمثلة:

‎/a My.msi

‎/a "subfolder1\My.msi"‎

‎/f[options][msifile]‎

فرض إصلاح تطبيق مقترن بالحزمة المحددة (ملف MSI). يجب أن تكون الحزمة المحددة موجودة في نفس المجلد مثل Setup.exe، ويجب أن يكون كلاهما عند جذر نقطة التثبيت الإداري. وبشكل آخر، يمكنك تحديد تعليمات المنتج البرمجية للحزمة، ويمكن نسخ تعليمات المنتج البرمجية من مقطع [المنتج] من ملف إعدادات برنامج التشغيل.

ملاحظة   يجب تحديد الحزمة نفسها التي تم استخدامها مسبقاً لتثبيت التطبيق.

قيم صالحة لـ <i>خيارات<i/> تتضمن التالي

a فرض إعادة تثبيت لكافة الملفات بغض النظر عن مجموعة التدقيق أو الإصدار.
c إعادة تثبيت ملف إذا كان مفقوداً أو معطوباً.
d إعادة تثبيت ملف إذا كان مفقوداً أو أن الإصدار الموجود مختلف.
e إعادة تثبيت ملف إذا كان مفقوداً أو أن الإصدار الموجود مطابق أو أقدم.
m إعادة كتابة كافة إدخالات تسجيل HKEY_LOCAL_MACHINE المطلوبة.
o إعادة تثبيت الملف إذا كان مفقوداً أو أن الإصدار الموجود أقدم.
p إعادة تثبيت الملف إذا كان مفقوداً فقط.
s إعادة تثبيت كافة الاختصارات والكتابة فوق الاختصارات الموجودة.
u إعادة كتابة كافة إدخالات تسجيل HKEY_CURRENT_USER المطلوبة.
v استرداد الحزمة من المصدر الأصلي وإعادة القيام بالتخزين المؤقت على الكمبيوتر المحلي.

الأمر كشف وإصلاح في تطبيق ينفذ الوظيفة نفسها مثل ‎/focums‎. تشغيل برنامج الإعداد واختيار إعادة التثبيت ينفذ الوظيفة نفسها مثل ‎/fecums‎. عند قيامك بالتثبيت، يحفظ Windows Installer الملف MSI على الكمبيوتر المحلي. عندما تستخدم الخيار ‎/fvm‎ لفرض إعادة القيام بالتخزين المؤقت وإعادة التثبيت، يقوم Windows Installer باسترداد الملف MSI من المصدر الأصلي ويقوم بإعادة التخزين المؤقت له على الكمبيوتر المحلي. يمكنك استخدام الخيار ‎/fvm‎ لتحديث أجهزة كمبيوتر العملاء بعد قيامك بتصحيح نقطة تثبيت إداري.

هام إذا قام مستخدم بتطبيق تصحيحات عميل (ثنائية) على جهاز كمبيوتر، فلن يكون بإمكانك استخدام ‎/f لإعادة القيام بالتخزين المؤقت وإعادة التثبيت على هذا الكمبيوتر من نقطة تثبيت إداري تم تحديثها. في هذه الحالة، يجب على المستخدمين إزالة التثبيت وإعادة التثبيت من الصورة الإدارية التي تم تحديثها.

مثال:

‎/fpiwae My.msi

‎/fvm {12345678-1234-1234-1234-123456789123}‎

‎/i [msifile]‎

تثبيت التطبيقات باستخدام الحزمة المحددة. يجب أن تكون الحزمة في المجلد نفسه مثل Setup.exe.

ملاحظة افتراضياً، يقوم Setup.exe بتوجيه Windows Installer لتنفيذ الوظيفة نفسها مثل ‎/i.

أمثلة:

‎/i My.msi

‎/i "subfolder1\My.msi"

‎/j[option] [msifile] [/t mstfile]‎

إعلان عن التطبيق على الكمبيوتر والتثبيت عند أول استخدام؛ يجب تحديد خيار للإعلان عن التطبيق لكل من الكمبيوتر أو المستخدم. يمكنك استخدام ‎/j فقط عند تشغيل برنامج الإعداد من نقطة تثبيت إدارية أو صورة قرص مضغوط على الشبكة. إذا لم يتم تحديد حزمة، يستخدم برنامج الإعداد الحزمة المحددة في Setup.ini. لتطبيق تحويل إلى التطبيق المُعلن عنه، استخدم الخيار ‎/t وحدد ملف MST.

قيم صالحة للخيار تتضمن التالي:

m إعلان لكافة المستخدمين على الكمبيوتر.
u إعلان للمستخدم الحالي.

ملاحظة   بالإضافة إلى ‎/t، يمكنك استخدام خيارات سطر الأوامر الثلاثة التالية عند استخدامك لـ ‎/j للإعلان عن التطبيق: ‎/l، و‎/q، و‎/‎settings.

مثال:

‎/jm My.msi /t Custom.mst

‎/l[options] logfile

إنشاء سجل لإجراءات التثبيت لبرنامج الإعداد وملف سجل لكل مهمة لـ Windows Installer. يقوم الخيار ‎/l بتجاوز الإعدادات الإفتراضية في المقطع [Logging] من Setup.ini.

تتضمن قيم الخيارات التالي، وتلتقط البيانات المطابقة:

a بدء إعلام الإجراء
c معلمات واجهة المستخدم الابتدائية
e رسائل إعلام بالخطأ
i رسائل المعلومات فقط
m رسائل نفاد الذاكرة
o رسائل نفاد مساحة القرص
p قائمة جدول الخاصية بالتنسيق الخاصية=القيمة
r سجل بيانات الإجراء؛ يتضمن معلومات خاصة بالإجراء المحدد
u رسائل طلب المستخدم
v المسهب يتضمن رسائل التصحيح
w رسائل تحذير
* تشغيل كافة خيارات التسجيل باستثناء v
+ إلحاق بملف سجل موجود

ملف سجل يدل على اسم ومسار ملف السجل لإنشائه. عندما تُضمّن (*) في اسم ملف السجل، يقوم برنامج الإعداد بإنشاء اسم ملف فريد لكل مثيل لبرنامج الإعداد.

مثال:

‎/lv* "%temp%\MyApp Setup(*).txt"‎

سطر الأوامر هذا ينشئ ملفات السجل التالية:

‎/noreboot

لا تقم بإعادة تشغيل الكمبيوتر أو بعرض مربع حوار إعادة التشغيل عند نهاية التثبيت. يقوم الخيار ‎/noreboot بتعيين خاصية إعادة التمهيد لـ Windows Installer إلى ReallySuppress لكل حزمة مضمنة في التثبيت باستثناء الحزمة الأخيرة.

‎/p [mspfile]‎

تطبيق تحديث إداري (ملف MSP) لتثبيت عميل. يمكنك أيضاً استخدام ‎/p لتطبيق تحديث لتثبيت إداري بتضمين الخيار ‎/a واسم ومسار الملف MSI في نقطة التثبيت الإداري. لتطبيق التصحيح، قم بتضمين ‎/qbفي سطر الأوامر لإنشاء ملف سجل، قم بتضمين ‎/l.

أمثلة:

‎msiexec /p [mspfile] /qb /l[options]‎

msiexec /p [mspfile] /a [msifile] /qb /l[options]

‎/q[option]‎

تعيين مستوى عرض واجهة المستخدم لبرنامج الإعداد.

قيم صالحة للخيارات تتضمن التالي:

b عرض فقط مؤشرات تقدم بسيطة ورسائل إعلام بالخطأ (أساسي).
f عرض كافة مربعات الحوار والرسائل؛ مكافئ لإغفال الخيار ‎/q (كامل).
n عرض بلا واجهة مستخدم؛ مكافئ لتحديد ‎/q من دون خيارات (بلا).
r عرض كافة مؤشرات التقدم ورسائل الإعلام بالخطأ ولكن بلا تجميع معلومات المستخدم (مخفض).
- يمنع كافة مربعات الحوار الشرطية؛ مستخدم مع b فقط.
+ إضافة رسالة إكمال إلى الخيار n أو b.

ملاحظة   تُعرض رسالة الإكمال فقط عندما لا يحتاج برنامج الإعداد إلى إعادة تشغيل الكمبيوتر بعد التثبيت.

‎/settings file

تحديد ملف إعدادات برنامج إعداد مخصص لـ Setup.exe ليستخدم بدلاً من Setup.ini. ملف الإعدادات يجب أن يكون في المجلد نفسه مثل Setup.exe، أو يجب تضمين المسار في سطر الأوامر.

مثال:

‎/settings MyApp.ini

‎/x [msifile]‎

إزالة التطبيق المقترن بالحزمة المحددة. يجب أن تكون الحزمة في المجلد نفسه مثل Setup.exe، ويجب أن يكون كلاهما عند جذر نقطة التثبيت الإداري.

ملاحظة  يجب عليك تحديد الحزمة نفسها التي تم استخدامها أساساً لتثبيت التطبيق.

مثال:

‎/x My.msi

خاصية=قيمة

تحديد قيمة خاصية في سطر الأوامر. إذا كانت القيمة تحتوي على مسافات، فعليك إحاطتها بعلامات اقتباس مزدوجة ("). لتحديد اثنين أو أكثر من أزواج خاصية-قيمة، فافصل بينها بمسافات.

ALLUSERS=[string]‎

تثبيت التطبيق لكافة المستخدمين على الكمبيوتر أو للمستخدم الحالي فقط. افتراضياً، يقوم Windows Installer بالتثبيت لكافة المستخدمين على الكمبيوتر. إعداد قيمة ALLUSERS إلى الصفر ("") يتجاوز هذا السلوك الافتراضي ويقوم بالتثبيت حسب المستخدم.

1 = تثبيت لكافة المستخدمين على الكمبيوتر؛ يتطلب امتيازات إدارية.

2 = تثبيت لكافة المستخدمين على الكمبيوتر.

"" = تثبيت للمستخدم الذي يقوم بتشغيل برنامج الإعداد فقط.

ALLUSER=""‎

CDCACHE=[string]‎

تحديد مستوى التخزين المؤقت.

تلقائي = تخزين مؤقت مستند إلى مساحة القرص الحرة المتوفرة

1 = تخزين مؤقت لما تقوم بتثبيته فقط

2 = تخزين مؤقت لكامل المصدر

0 = تخزين مؤقت معطل

CDCACHE=auto

COMPANYNAME=[string]

تحديد اسم مؤسسة.

COMPANYNAME=My Business

INSTALLLOCATION=[string]

تحديد موقع التثبيت.

INSTALLLOCATION=C:\Program Files\MyApp

LOCALCACHEDRIVE=[string]

تحديد محرك الأقراص الذي سيجري التخزين المؤقت لملفات التثبيت عليه.

LOCALCACHEDRIVE=C

PIDKEY=[string]‎

إدخال مفتاح ترخيص جماعي من 25 حرفاً في سطر أوامر برنامج الإعداد أو في ملف إعدادات برنامج الإعداد. عند تعيينك لخاصية PIDKEY، لن يُطلب من المستخدمين إدخال مفتاح المنتج product key عند قيامهم بالتثبيت.

PIDKEY=123467890123456789012345

TRANSFORMS=[string]

تحديد تحويل لتطبيقه على التثبيت.

TRANSFORMS=\\server\share\myApp\Custom.mst

USERNAME=[string]

تحديد اسم مستخدم افتراضي.

USERNAME=Don Dunk