Gacutil.exe (أداة مخزن التجميع العمومي المؤقت)

أداة مخزن التجميع العمومي المؤقت تمكنّك من عرض ومعالجة محتويات مخزن التجميع العمومي المؤقت و تحميل ذاكرة التخزين المؤقت.

يتم تثبيت أداة مخزن التجميع العمومي المؤقت تلقائياً مع ‏‫Visual Studio. و لتشغيل الأداة استخدم موجه أوامر Visual Studio.. في موجه الأوامر، اكتب ما يلي:

gacutil [options] [assemblyName | assemblyPath | assemblyListFile]

المعلمات

الخيار	الوصف
cdl/	تحذف محتويات ذاكرة التنزيل المؤقت.
‎/f	حدد هذا الخيار مع الخيارات /i أو /il لفرض التجميع إلى إعادة التثبيت. إذا كان هناك تجميع موجوداً بالفعل بنفس الاسم في مخزن التجميع العمومي المؤقت , الأداة تقوم بالكتابة فوقه.
/h[elp]	يقوم بعرض بناء جملة الأمر والخيارات للأداة.
/i مسار التجميع	يثّبت التجميع في مخزن التجميع العمومي المؤقت.
/if مسار التجميع	يثّبت التجميع في مخزن التجميع العمومي المؤقت. إذا كان هناك تجميع موجوداً بالفعل بنفس الاسم في مخزن التجميع العمومي المؤقت , الأداة تقوم بالكتابة فوقه. تحديد هذا الخيار مكافئ لتحديد الخيارات /i و /f معاً.
/il ملف قائمة التجميع	تثبت تجميع واحد أو أكثر المحددة في ملف قائمة التجميع إلى مخزن التجميع العمومي المؤقت.
/ir مسار التجميع نظام معرف نشرة الأمان	يقوم بتثبيت تجميع في مخزن التجميع العمومي المؤقت ثم يضيف مرجعاً لحساب التجميع. يجب عليك تحديد المعلّمات مسار التجميع, النظام, المعرّف , و الوصف مع هذا الخيار. للحصول على وصف للقيم الصالحة يمكنك التحديد لهذه المعلمات, راجع الخيار / r. تحديد هذا الخيار مكافئ لتحديد الخيارات /i و /r معاً.
/l [ إسم التجميع ]	يسرد محتويات مخزن التجميع العمومي المؤقت. إذا حددت المعلّمة إسم التجميع ، الأداة تسرد فقط التجميعات المتطابقة مع هذا الاسم.
ldl/	تسرد محتويات ذاكرة التخزين المؤقت للملفات التي تم تحميلها.
/lr [ إسم التجميع ]	يسرد كل التجميعات وحسابات المرجع المطابق. إذا حددت المعلمة إسم التجميع، الأداة تسرد فقط التجميعات المتطابقة مع هذا الاسم و الحسابات المقابلة الخاصة بها.
/nologo	يقوم بمنع عرض شعار بدء التشغيل للـ Microsoft.
/r [إسم التجميع | مسار التجميع] نظام معرف نشرة الأمان	تعين مرجع تتبّع إلى تجميع أو تجميعات لتثبيتها أو إزالة تثبيتها. حدد هذا الخيار مع الخيارات /i, /il, /u أو /ul. لتثبيت تجميع عليك تحديد المعلّمات مسار التجميع, نظام, المعرف, و الوصف مع هذا الخيار. لإزاله تثبيت تجميع فعليك تحديد المعلمات إسم التجميع, نظام, المعرف, و الوصف معلمات. لإزالة مرجع إلى تجميع, يجب عليك تحديد نفس المعلمات نظام, المعرف و وصف التي تم تحديدها بواسطة الخيارات /i و / r( أو /ir) عندما تم تثبيت التجميع. إذا تم إلغاء تثبيت التجميع ، الأداة تزيل أيضاً التجميع من مخزن التجميع العمومي المؤقت إذا كان المرجع الأخير لإزالتة و إذا كان مثبت Windows لديه مراجع معلقة إلى التجميع. المعلمة نظام تعيّن نوع نظام التثبيت. يمكنك تحديد احدى القيم التالية: UNINSTALL_KEY: عيّن هذه القيمة إذا أضاف المثبت التطبيق إلى البرامج إضافة/إزالة في Microsoft Windows. التطبيقات تضيف نفسها إلى البرامج إضافة/إزالة عن طريق إضافة مفتاح السجل إلى HKLM\Software\Microsoft\Windows\CurrentVersion. FILEPATH: حدد هذه القيمة إذا لم يضف المثبت التطبيق إلى البرامج إضافة/إزالة. OPAQUE: حدد هذه القيمة إذا توفير مفتاح السجل أو مسار الملف لا يطبق على سيناريو التثبيت. تسمح لك هذه القيمة بتحديد معلومات تخصيص للمعلمة المعرف. القيمة المعيّنة من أجل المعلّمة المعرف تعتمد على القيمة المحددة من أجل المعلّمة نظام: إذا حددت UNINSTALL_KEY للمعلمة نظام، حدد اسم مجموعة التطبيق في مفتاح السجل HKLM\Software\Microsoft\Windows\CurrentVersion. على سبيل المثال، إذا كان مفتاح السجل HKLM\Software\Microsoft\Windows\CurrentVersion\MyApp, حدد MyApp للمعلمة المعرف. إذا حددت FILEPATH للمعلمة نظام،حدد المسار الكامل إلى الملف التنفيذي الذي يثبت التجميع كالمعلمة المعرف. إذا حددت OPAQUE للمعلمة نظام المعلمة, يمكنك توفير أي جزء من البيانات كالمعلمة المعرف. يجب وضع البيانات التي تحددها ضمن علامات اقتباس (""). المعلمة وصف تسمح لك بتحديد نص وصفي حول التطبيق الذي سيثّبت. يتم عرض هذه المعلومات عندم يتم تعداد المراجع.
هدوء	تمنع عرض كل الإخراج.
/u [ إسم التجميع ]	يلغي تثبيت التجميع من مخزن التجميع العمومي المؤقت.
/uf [ إسم التجميع ]	يفرض تجميع محدد إلى أزالة التثبيت عن طريق إزالة كل المراجع إلى التجميع. تحديد هذا الخيار مكافئ لتحديد الخيارات /u و /f معاً. ملاحظة لا يمكنك استخدام هذا الخيار لإزالة تجميع تم تثبيته باستخدام مثبت Microsoft Windows.إذا حاولت القيام بهذه العملية, الأداة تعرض رسالة خطأ.
/ul ملف قائمة التجميع	يلغي تثبيت تجميع واحد أو أكثر المحددة في ملف قائمة التجميع من مخزن التجميع العمومي المؤقت.
/u[ngen] إسم التجميع	تلغي تثبيت تجميع محدد من مخزن التجميع العمومي المؤقت. إذا كان التجميع المحدد لديه حسابات مرجع موجود , فإن الأداة تعرض حسابات المرجع و لا تقوم بإزالة التجميع من ذاكرة التجميع العمومي المؤقت. ملاحظة في الإصدار 2.0 من NET Framework. , /ungen غير معتمدة.بدلاً من ذلك , إستخدم الأمر uninstall ل Ngen.exe (مولد النسخة الأصلي). في إصدارات 1.0 و 1.1 من NET Framework. , تحديد / ungen يؤدي Gacutil.exe لإزالة التجميع من مخزن النسخة الأصلية المؤقت. ذاكرة التخزين المؤقت هذه تخزن النسخ الأصلية للتجميعات التي تم إنشاؤها باستخدام Ngen.exe (مولد النسخة الأصلي).
/ur [ إسم التجميع ] نظام معرف نشرة الأمان	يلغي تثبيت مرجع إلى تجميع محدد من ذاكرة التجميع العمومي المؤقت. لإزالة مرجع إلى تجميع, يجب عليك تحديد نفس المعلمات نظام, المعرف و وصف التي تم تحديدها بواسطة الخيارات /i و / r( أو /ir) عندما تم تثبيت التجميع. للحصول على وصف للقيم الصالحة يمكنك التحديد لهذه المعلمات, راجع الخيار / r. تحديد هذا الخيار مكافئ لتحديد الخيارات /u و /r معاً.
/?	يقوم بعرض بناء جملة الأمر والخيارات للأداة.

ملاحظات

هذه الأداة توفر الكثير من نفس الوظيفة لعرض ذاكرة التخزين المؤقت كملحق Shfusion.dll) Windows Shell) ولكنها قابلة للاستخدام أكثر من بناء البرامج النصية , ملفات العمل والملفات الدفعية.

ملاحظة
يجب أن يكون لديك امتيازات المسؤول لكي تتمكن من استخدام Gacutil.exe.

وعلى وجه الخصوص، Gacutil.exe تسمح لك بتثبيت التجميعات في ذاكرة التخزين المؤقت إزالتها من ذاكرة التخزين المؤقت وسرد محتويات ذاكرة التخزين المؤقت.

يوفر Gacutil.exe خيارات التي تدعم حساب المرجع المشابهة لنظام عد المرجع المدعم بواسطة مثبت Windows . يمكنك استخدام Gacutil.exe لتثبيت تطبيقين الذين يثّبتون التجميع نفسه , الأداة تتعقّب عدد مراجع التجميع. ونتيجة لذلك، سيتبقى التجميع على الكمبيوتر حتى يتم إلغاء تثبيت كلا التطبيقين. إذا كنت تستخدم Gacutil.exe لعمليات تثبيت المنتج الفعلية, استخدم الخيارات التي تدعم عد المرجع. استخدم الخيارين /i و / r معاً لتثبيت تجميع وأضف مرجعاً لحسابه. استخدم الخيارات /u و / r معاً لإزالة حساب مرجع لتجميع. يجب أن تدرك أن استخدام الخيارات /i و /uلا يدعم عد المرجع. هذه الخيارات مناسبة للاستخدام أثناء تطوير المنتجات ولكن ليس لعمليات تثبيت المنتج الفعلية.

استخدم الخيارات /il أو /ul لتثبيت أو إزالة تثبيت قائمة التجميعات التي تم تخزينها في ملف نصي ‏‫ANSI. يجب أن يتم تنسيق محتويات الملف النصي بشكل صحيح. لاستخدام ملف نصي لتثبيت التجميعات قم بتحديد مسار لكل تجميع على خط منفصل في الملف. يوضح المثال التالي محتويات ملف يحتوي على تجميعات لتثبيتها.

myAssembly1.dll
myAssembly2.dll
myAssembly3.dll

لاستخدام ملف نصي لإزالة تثبيت التجميعات, حدد اسم التجميع المؤهل بالكامل لكل تجميع على خط منفصل في الملف. يوضح المثال التالي محتويات ملف يحتوي على تجميعات لإلغاء تثبيتها.

myAssembly1,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly2,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly3,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab

أمثلة

يقوم الأمر التالي بتثبيت التجميع mydll.dll في مخزن التجميع العمومي المؤقت.

gacutil /i mydll.dll

يقوم الأمر التالي بإزالة التجميع hello من مخزن التجميع العمومي المؤقت طالما لا يوجد عد مرجع للتجميع.

gacutil /u hello

لاحظ أنه الأمر السابق قد يزيل تجميع واحد أو أكثر من مخزن التجميع المؤقت لأنه لم يتم تحديد اسم التجميع بشكل كامل. على سبيل المثال، إذا تم تثبيت الإصدارات 1.0.0.0 و 3.2.2.1 من hello في ذاكرة التخزين المؤقت، الأمر gacutil /u hello يزيل كلا التجميعين.

استخدم المثال التالي لتجنب إزالة أكثر من تجميع واحد. يزيل هذا الأمر فقط التجميع hello الذي يطابق رقم الإصدار المعين بشكل كامل , الثقافة والمفتاح العمومي.

gacutil /u hello, Version=1.0.0.1, Culture="de",PublicKeyToken=45e343aae32233ca

يقوم الأمر التالي بتثبيت التجميعات المحددة في الملف assemblyList.txt إلى مخزن التجميع العمومي المؤقت.

gacutil /il assemblyList.txt

الأمر التالي يزيل التجميعات المحددة في الملف assemblyList.txt من مخزن التجميع العمومي المؤقت.

gacutil /ul assemblyList.txt

يقوم الأمر التالي بتثبيت myDll.dll ثم يضيف مرجعاً لحسابه. التجميع myDll.dll يستخدم بواسطة التطبيق MyApp. المعلمة UNINSTALL_KEY MyApp تعيّن مفتاح السجل الذي يضيف MyApp إلى برامج إضافة/إزالة في Windows. معلمة الوصف تحدد ك My Application Description.

gacutil /i /r myDll.dll UNINSTALL_KEY MyApp "My Application Description"

يقوم الأمر التالي بتثبيت myDll.dll ثم يضيف مرجعاً لحسابه. المعلمة نظام , FILEPATH، والمعلمة معرّف , c:\applications\myApp\myApp.exe، حدد المسار إلى التطبيق الذي يقوم بتثبيت myDll.dll. المعلمة وصف تحدد كـ MyApp.

gacutil /i /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp

يقوم الأمر التالي بتثبيت myDll.dll ثم يضيف مرجعاً لحسابه. المعلمة نظام ,OPAQUE، تسمح لك بتخصيص المعلمات وصف و المعرف.

gacutil /i /r mydll.dll OPAQUE "Insert custom application details here" "Insert Custom description information here"

يقوم الأمر التالي بإزالة المرجع إلى myDll.dll بواسطة التطبيق myApp. إذا كان هذا هو المرجع الأخير إلى التجميع, فإنه سيقوم أيضاً بإزالة التجميع من مخزن التجميع العمومي المؤقت.

gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp

يسرد الأمر التالي محتويات مخزن التجميع العمومي المؤقت.

gacutil /l

راجع أيضًا:

المرجع

Shfusion.dll (مستعرض ذاكرة التخزين المؤقت للتجميع)

Regasm.exe (أداة تسجيل التجميع)

موجه أوامر Visual Studio.

المبادئ

ذاكرة التخزين المؤقتة للتجميع العمومي

موارد أخرى

أدوات .NET Framework