Installutil.exe (أداة المثبت)
أداة المثبت هي أداة مساعدة لسطر الأوامر التي تسمح لك بتثبيت و إالغاء تثبيت موارد الخادم بواسطة تنفيذ مكونات المثبت في تجميع محدد. هذه الأداة تعمل بالاقتران مع فئات في مساحة الإسم System.Configuration.Install.
يتم تلقائياً تثبيت أداة المثبت مع Visual Studio, و لتشغيل المثبت استخدم موجه أوامر Visual Studio.. في موجه الأوامر، اكتب ما يلي:
installutil [/uninstall][option [...]]assemblyname ]
[option [...]]assemblyname
ملاحظات
الوسيطة |
الوصف |
|---|---|
إسم التجميع |
إسم التجميع الذي فيه يتم تنفيذ مكونات المثبت. |
الخيار |
الوصف |
|---|---|
h/ [تعليمات] |
يقوم بعرض بناء جملة الأمر والخيارات للأداة. |
/help مسار التجميع |
يعرض أية خيارات إضافية المتعرّف عليها من قبل المُثبّتات الفردية داخل التجميع المحدد. |
/? |
يقوم بعرض بناء جملة الأمر والخيارات للأداة. |
/? مسار التجميع |
يعرض أية خيارات إضافية المتعرّف عليها من قبل المُثبّتات الفردية داخل التجميع المحدد. |
/LogFile=[إسم الملف] |
تعين اسم ملف السجل حيث يتم تسجيل تطور التثبيت . الافتراضي هو إسم التجميع .InstallLog. |
/AssemblyName assemblyName [,الإصدار=major.minor.build.revision] الثقافة =إعدادات محلية [,رمز المفتاح العام=publicKeyToken]] |
تحدد إسم التجميع. يجب أن يكون اسم التجميع مؤهل بشكل كامل مع الإصدار ,الثقافة و رمز المفتاح العام للتجميع. يجب إحاطة الغسم المؤهل بشكل كامل بعلامات إقتباس. على سبيل المثال، "myAssembly , الثقافة = محايد , رمز المفتاح العام = 0038abc9deabfle5 , الإصدار = 2.0.0.0" هو اسم تجميع مؤهل بشكل كامل. |
/LogToConsole={صواب|خاطئة} |
إذا صواب , يعرض الإخراج إلى وحدة التحكم. إذا خطأ (الافتراضي) يمنع الإخراج إلى وحدة التحكم. |
ShowCallStack/ |
تطبع مكدس الاستدعاءات إلى السجل في حالة حدوث استثناء عند أي نقطة أثناء التثبيت. |
/u[ninstall] |
تلغي تثبيت التجميع. بخلاف الخيارات الأخرى، /u تطيق على كل التجميعات بصرف النظر عن مكان ظهورها على خط الأوامر. |
ملاحظات
بدءاً من برنامج NET Framework. الإصدار 2.0 , الإصدار ٣٢ بت من وقت تشغيل اللغة العامة (CLR) يستمر بالتحميل مع الإصدار 32-بت من أداة المثبت, لكن إصدار 64 بت من وقت تشغيل اللغة العامة يأتي مع كل الإصدار 32 بت و إصدار 64 بت من أداة المثبت. عند استخدام 64-bit من وقت التشغيل العام للغات (CLR) ، استخدم أداة المثبت 32-بت لتثبيت تجميعات 32 بت و المثبت 64-بت لتثبيت ٦٤ بت و اللغة المتوسطة Microsoft. وإلا، كلا من اصداري أداة المثبت تتصرف بنفس الطريقة.
تتكون تطبيقات Microsoft .NET Framework من ملفات برنامج تقليدية و موارد مقترنة، مثل الرسائل في قوائم الانتظار سجلات الأحداث و عدادات الأداء التي يجب إنشاءها عند نشر التطبيق. يمكنك استخدام مكونات المثبت الخاص بالتجميع لإنشاء هذه الموارد عندما يتم تثبيت التطبيق الخاص بك و لإزالتهم عند إزالة تثبيت التطبيق الخاص بك. Installutil.exe يكتشف و ينفذ مكونات المثبت هذه.
يمكنك تحديد تجميعات متعددة على نفس خط الأوامر. أي خيار يحدث قبل أن ينطبق اسم التجميع إلى تثبيت ذلك التجميع. الخيارات المحددة لتجميع واحد تنطبق على أي تجميعات لاحقة إلا إذا تم تحديد الخيار مع إسم التجميع الجديد.
إذا قمت بتشغيل Installutil.exe مقابل تجميع دون تحديد أية خيارات فإنه يضع الملفات الثلاثة التالية في دليل التجميع:
InstallUtil.InstallLog
يحتوي على وصف عام لتقدم عملية التثبيت.
إسم التجميع .InstallLog
يحتوي على معلومات خاصة لمرحلة تنفيذ عملية التثبيت. للحصول على معلومات أكثر حول مرحلة التنفيذ, راجع أسلوب Installer.Commit.
إسم التجميع .InstallState
يحتوي على البيانات المستخدمة في إزاله تثبيت التجميع.
يستخدم Installutil.exe الانعكاس لفحص التجميع المحدد والبحث عن كل أنواع Installer مع تعيين RunInstallerAttribute إلى صواب. ثم تقوم الأداة بتنفيذ إما أسلوب Install أو أسلوب Uninstall لكل مثيل للنوع المثبت. Installutil.exe تنفذ التثبيت بطريقة معاملات; إذا فشل أحد التجميعات في التثبيت, فإنها تعيد التثبيتات لكل التجميعات الأخرى. أزاله التثبيت ليست معاملات.
لا يمكن ل Installutil.exe تثبيت او إزالة تثبيت تجميعات موقعة متأخراً و لكن يمكن تثبيت أو إزالة تثبيت تجميعات الأسماء القوية.
لاحظ أن لا يمكنك نشر خدمة Windows تم إنشاؤها باستخدام ++C مع Installutil.exe. لا يمكن ل Installutil.exe التعرف على تعليمة برمجية أصلية مضمنة التي تم إنتاجها من قبل برنامج التحويل البرمجي ل ++C . في حالة محاولة نشر خدمة C++ Windows مع Installutil.exe , يتم إالقاء إستثناء BadImageFormatException. للعمل مع هذا السيناريو, أنقل تعليمات برمجية الخدمة إلى الوحدة النمطية لـ ++C. بعد ذلك، قم بكتابة كائن المثبت في #C أو Visual Basic.
أمثلة
يعرض الأمر التالي وصف لبناء جملة الأمر و الخيارات.
installutil
الأمر التالي ينفذ مكونات المثبت في التجميع myAssembly.exe.
installutil myAssembly.exe
ينفذ الأمر التالي مكونات المثبت في التجميع باستخدام مبدل AssemblyName/ و اسم مؤهل بشكل كامل.
installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=2.0.0.0"
الأمر التالي ينفذ مكونات عدم التثبيت في التجميع myAssembly.exe.
installutil /u myAssembly.exe
ينفذ الأمر التالي المثبتات في التجميع myAssembly.exe ويعيّن كتابة معلومات التقدم إلى myLog.InstallLog.
installutil /LogFile=myLog.InstallLog myAssembly.exe
الأمر التالي يكتب تقدم التثبيت ل myAssembly.exe إلى myLog.InstallLog ويقوم بكتابة التقدم لـ myTestAssembly.exe إلى myTestLog.InstallLog.
installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile = myTestLog.InstallLog myTestAssembly.exe