TFSDeleteProject: حذف مشاريع الفريق

يمكنك إزالة مشروع فريق من Team Foundation Server عندما لا يعد المشروع مطلوباً باستخدام TFSDeleteProject. بالإضافة إلى ذلك، إذا كان هناك مكونات تبقى لا تحذف بعد إنشاء غير ناجح لمشروع فريق يمكنك استخدام TFSDeleteProject لإزالتها.

هام

يدمر TFSDeleteProject مشروع الفريق بشكل دائم فلا تستطيع استرداده بعد ذلك. يجب عليك إجراء نسخ احتياطي لكافة بيانات المشروع الهامة قبل استخدام TFSDeleteProject.

يمكنك العثور على أداة سطر الأوامر فى TFSDeleteProject القرص: : \Program Files\Microsoft 10.0\Common7\IDE Visual Studio على أي كمبيوتر عميل يقوم بتشغيل مستكشف الفريق.

ملاحظة

حتى لو قمت بتسجيل الدخول بأذونات إدارية، يجب أن تقوم بفتح نافذة موجه أوامر غير مقيد لتنفيذ هذه الوظيفة على خادم يقوم بتشغيل Windows Server 2008. لفتح نافذة موجه أوامر غير مقيدة، انقر فوق ابدأ، ثم انقر بزر الماوس الأيمن فوق موجه الأوامر ثم انقر فوق تشغيل كمسؤول. لمزيد من المعلومات، راجع موقع الويب Microsoft: التحكم في وصول المستخدم.

الأذونات المطلوبة.

لاستخدام الأمر TFSDeleteProject يجب أن تكون عضواً في مجموعة الأمان مسؤولي أساس الفريق أو مجموعة الأمان مسؤولي المشروع للمزيد من المعلومات، راجع أذونات خادم أساس الفريق والمجموعات و الأذونات و الأدوار الافتراضية لخادم Team Foundation.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

المعلمات

الخيار	الوصف
/q	اختياري. استخدم الوضع الهادئ. لا تطالب المستخدمين بالتأكيد.
/force	اختياري. تحدد أن عملية الحذف يجب أن تتابع حتى إذا لم يتمكن من حذف بعض المكونات.
/excludewss	اختياري. تحدد عدم حذف موقع SharePoint الذي يقترن بمشروع الفريق. حدد هذا الخيار للمحافظة على الموقع الموجود بحيث يمكن لمشاريع الفريق الأخرى متابعة استخدامه.
/collection:URL	مطلوبة. تعيين URI الخاص بمجموعة مشروع الفريق. يجب استخدام ما يلي تنسيق ل URI: http: / / ServerName:Port/VirtualDirectoryName/CollectionName في حالة عدم تحديد الدليل ظاهري، يجب أن استخدم بالتنسيق التالي ل URI: http: / / ServerName:Port / CollectionName.
TeamProjectName	مطلوبة. اسم المشروع في حالة تضمين مسافات في cludes الاسم، في علامات اقتباس.

ملاحظات

عند إنشائك لمشروع فريق، يقوم Team Foundation Server بإنشاء كائنات البيانات على الخادم الذي يستضيف Team Foundation Server و قد يقوم بإنشاء كائنات البيانات على الخادم الذي يستضيف منتجات SharePoint و الخادم الذي يستضيف خدمات التقارير SQL Server. عندما تقوم بإزالة مشروع الفريق, يتم تلقائياً إزالة التقارير من خدمات التقارير SQL Server.

عندما تقوم بإزالة مشروع فريق، يمكنك اختيار أم لا إلى إزالة الكائنات التي تم إنشاؤها إلى تعتمد على موقع SharePoint. ومع ذلك، يمكن أن يمنع خطأ Team Foundation Server من إنشاء أو حذف كافة الكائنات. لاستكشاف هذه المشكلات توفر المقاطع التالية معلومات أساسية و ارتباطات لموارد أخرى و خطوات محددة تساعد في تحديد سبب المشكلة و تقوم بحل المشكلة و عند الضرورة حذف كائنات البيانات التي تبقى بعد تشغيل TFSDeleteProject.

• عملية TFSDeleteProject

• البيانات التي يمكن أن تبقى غير محذوفة

• تحقق من حذف مكونات مشروع الفريق

• إزالة المكونات المتبقية بعد الحذف الجزئي للمشروع

• زيادة الفترة المهملة

عملية TFSDeleteProject

عند استخدامك أداة سطر الأوامر TFSDeleteProject ، فهى تحذف أولاً بيانات المشروع و من ثم مواقع المشروع علي الويب.

المرحلة 1: يقوم TFSDeleteProject بحذف بيانات المشروع

في المرحلة الأولى يقوم TFSDeleteProject تلقائياً بتنفيذ الخطوات التالية لإزالة بيانات مشروع الفريق:

1. يقوم TFSDeleteProject بإنشاء جرد لكافة المكونات التي يتم ترشيحهم للحذف. يتضمن هذا المكونات التي تتكامل مع Test Manager و بنية Team Foundation و التحكم بالإصدار Team Foundation.

2. يقوم TFSDeleteProject بحذف المكون الذي يعرض عقدة المشروع فيمستكشف الفريق.

3. يقوم TFSDeleteProject بالإشارة إلي بيانات تحكم الإصدار من أجل الحذف ولكنه لا يقوم بحذف هذه المعلومات مباشرةً. تتضمن المعلومات كافة فروع عنصر تحكم الإصدار في المشروع المحدد ولكن ليس الفروع الأخرى خارج المشروع.

   • إذا كان الأصل و التابع كلاهما في المشروع، يقوم TFSDeleteProject بالإشارة إلي أن كليهما يحذف.

   • إذا كانت فروع الأصل والتابع في مشاريع مختلفة يقوم TFSDeleteProject بالإشارة إلي الفرع المحدد فقط.

   • إذا كان مشروع آخر فرع من المشروع المحدد يقوم TFSDeleteProject بالإشارة إلي المشروع المحدد فقط. عند حذف المشروع المحدد يصبح المشروع الفرع معزول.

4. يقوم TFSDeleteProject مباشرةً بحذف بيانات البناء، بما في ذلك المعلومات و البيانات الأساسية و تعريفات البناء و عملاء البناء و نتائج الاختبار المقترنة بمشروع الفريق. لا تقوم الأداة بحذف مواقع فشل البناء. لا تحتاج لحذف موقع فشل البناء لمشروع فريق قديم قبل بناء مشروع فريق يستخدم نفس موقع فشل البناء.

   إذا كان المشروع المحدد يحتوي على كمية كبيرة من بيانات البناء قد لا ينتهي الحذف ضمن فترة المهلة. للتغلب على هذه المشكلة راجع زيادة فترة المهملة ثم قم بتشغيل TFSDeleteProject مرة أخرى.

5. يقوم TFSDeleteProject مباشرةً بحذف عناصر العمل و حقول عناصر العمل التي تنتمي إلى مشروع محدد و تقوم بحذف كافة بيانات التعريف الغير المشتركة.

   إذا كان المشروع المحدد يحتوي على كمية كبيرة من بيانات عنصر العمل قد لا ينتهي الحذف ضمن فترة المهلة. لحل هذه المشكلة، راجع زيادة الفترة مهملة ثم قم بتشغيل TFSDeleteProject مرة أخرى.

المرحلة 2: يقوم TFSDeleteProject بحذف مواقع المشروع علي الويب

في المرحلة الثانية يقوم TFSDeleteProject بحذف البيانات التالية:

هام

قد تأخذ هذه الخطوات وقتاً طويلاً من أجل الإكمال و أثناء هذا الوقت يمكنها تخفيض أداء الخادم.

• يقوم TFSDeleteProject باستخدام APIs خدمات التقارير لحذف التقارير على الخادم الذي يستضيف خدمات التقارير.

• TFSDeleteProject تقوم بحذف بوابة المشروع علي موقع الويب من الخادم الذي يستضيف منتجات SharePoint. تحدث هذه الخطوة فقط إذا كان المشروع يملك الموقع و لم يتم استبعاد الحذف في سطر الأوامر. (ضع في الاعتبار أن عدة مشاريع قد تشير لموقع منفرد ولكن واحد فقط منها يمكن أن يكون المالك حيث تقارير/لوحات المعلومات تستخدم بشكل افتراضي هذا المشروع).

  ملاحظة

  قبل حذف مشروع الفريق، يمكنك التأكد من أن خدمات التقارير و منتجات SharePoint يقومون باستخدام URLs الصحيحة للمشروع عن طريق التأكد من إعدادات البوابة. لمزيد من المعلومات، راجع إضافة بوابة لمشروع الفريق.

إذا قام TFSDeleteProject بحذف كافة ما سبق من عناصر البيانات بنجاح، تقوم بإرجاع الرسالة تم . للتحقق من هذه النتيجة راجع التحقق من حذف مكونات مشروع الفريق .

إذا لم يتم إزالة واحد أو أكثر من المكونات يمكنك إعادة تشغيل TFSProjectDelete باستخدام الخيار /force لمتابعة عملية الحذف حتى إذا كانت غير قادرة على حذف كافة عناصر البيانات. مع هذا الخيار، يتخطى TFSDeleteProject المكون الذى لم يستطع إزالته و يرجع رسالة خطأ و يحذف المكون التالي و يترك بيانات تعريف عنصر العمل وإعدادات الأمان سليمة.

البيانات التي يمكن أن تبقى غير محذوفة

البيانات التالية يمكن أن تبقي في التوزيع بعد إكمال TFSDeleteProject بنجاح:

• فريق مشروع ببيانات في مكعب. تبقي البيانات في مكعب مشروع الفريق حتى يتم إعادة بناء المكعب في أي وقت تقوم خدمة وحدة تحكم المستودع بإزالة كافة محفوظات بيانات البناء التي تم حذفها من قواعد البيانات Team Foundation.

• بناء ملفات و مجلدات الإفلات . ثنائيات البناء و ملفات سجل بناء و ملفات السجل التي تتضمن نتائج الاختبار، يتم نشرها خلال عملية البناء. مواقع هذه الملفات لم يتم حذفها. إذا كنت تريد إزالة هذه الملفات يجب عليك إزالتها يدوياً.

• عنصر عمل بتعقب بيانات التعريف التي هو المشترك. TFSDeleteProjectلا يحذف أي ملفات التعريف الخاصة بعنصر عمل التعقب التي هو المشتركة بين مشاريع الفريق.

• عنصر تحكم إصدار shelvesets الذي يحتوي على التعليمة البرمجية المشتركة . لا يتم حذف عنصر تحكم إصدار shelvesets إذا كان هناك تعليمة برمجية في shelveset من عدة مشاريع فريق.

تحقق من حذف المشروع

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

للتحقق من نجاح حذف مشروع فريق

1. افتح مستكشف الفريق ثم تحقق من أن المشروع لا يظهر كعقدة مشروع.

2. افتح Internet Explorer واكتب URL الخاص ببوابة موقع المشروع علي الويب. تحقق من أن الموقع لم يعد موجوداً.

3. في Internet Explorer في مربع العنوان، اكتب URL الخاص بموقع خدمات التقارير علي الويب باستخدام أحد تنسيقات URL التالية:

   • http:// خدمات التقارير / تقارير

   • http:// خدمات التقارير / التقارير_ TFSInstance

4. في إدارة التقارير، انقر فوق إظهار التفاصيل .

5. تحقق من أن المجلد لمشروع الفريق المحذوف لم يعد يظهر. انقر فوق مجلد الجذر TfsReports، ثم انقر فوق المجلد المسمى لمجموعة مشروع الفريق. يجب أن لا يكون هناك مجلد باسم المشروع المحذوف.

6. في حالة استمرار التقارير أو موقع ويب، راجع إجراء التالي.

إزالة المكونات المتبقية بعد الحذف الجزئي للمشروع

إذا كان بوابة موقع المشروع علي الويب و مجلد التقارير باقياً بعد حذف مشروع الفريق، قم بإزالة الموقع و المجلد يدوياً.

لإزالة-يدوياً- التقارير و موقع بوابة المشروع علي الويب الخاص بمشروع الفريق المحذوف

1. قم بتسجيل الدخول إلى الخادم الذي يستضيف خدمات التقارير لمشروع الفريق الذي قمت بحذفه.

2. افتح Internet Explorer و في مربع العنوان اكتب URL الخاص بموقع خدمات التقارير علي الويب باستخدام أحد تنسيقات URL التالية:

   • https://localhost/Reports

   • **https://localhost/Reports_**TFSInstance

3. في إدارة التقارير، انقر فوق إظهار التفاصيل .

4. انقر فوق مجلد الجذر TfsReports، ثم انقر فوق المجلد المسمى لمجموعة مشروع الفريق.

5. حدد خانة الاختيار لمشروع الفريق الذي قمت بحذفه.

6. انقر فوق حذف.

7. انقر فوق موافق لتأكيد رغبتك في حذف مجلد التقارير الخاص بمشروع الفريق.

8. إلى إزالة موقع ويب المدخل مشروع مشروع الفريق المحذوف، راجع الصفحة التالية الموجودة على موقع Microsoft Office 2010 Suite على ويب: كيفية القيام بما يلي: إنشاء و تحرير و حذف مواقع خدمات Windows SharePoint.

زيادة الفترة المهملة

بشكل افتراضي، كل خدمة ويب تقوم باستدعاء مشكلات الأمر TFSDeleteProject لحذف مكون يجب أن تتم خلال 10 دقائق. إذا كان هناك ست استدعاءات، قد تستغرق العملية حتي ساعة من الوقت. إذا كنت ترغب في حذف مشروع فريق مقترن بكمية كبيرة من البيانات, يمكنك زيادة فترة المهلة بشكل مؤقت.

ملاحظة

في حالة زيادة فترة المهلة سيؤثر التغيير على كافة استدعاءات خدمة ويب. بشكل عام، تريد الحفاظ علي فترة المهلة حتى 10 دقائق لمنع استدعاءات خدمة ويب من إخفاض أداء الخادم و التسبب في منع المستخدمين من استخدام واجهة المستخدم لفترات طويلة من الوقت. لذلك، بعد حذف المشروع بنجاح, يجب عليك تغيير فترة المهلة مرة أخرى إلي 10 دقائق.

الأذونات المطلوبة.

لإكمال هذه الإجراءات يجب أن تكون مسؤول Windows علي خادم على مستوى التطبيق.

هام

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

لزيادة فترة المهلة للأمر TFSDeleteProject

1. قم بتسجيل الدخول إلى خادم على مستوي التطبيق.

2. انقر فوق ابدأ، انقر فوق تشغيل ، نوع regedit، ثم انقر فوق ‏‏موافق .

3. في جزء المستعرض قم بتوسيع HKEY_ LOCAL_MACHINE:

   • إذا كان الخادم يعمل بنظام التشغيل 32-بت، قم بتوسيع: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings.

   • إذا كان الخادم يعمل بنظام التشغيل 64-بت، قم بتوسيع: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings.

4. في حالة عدم وجود المفتاح TeamFoundation\RequestSettings اتبع الخطوات التالية لإنشائه:

   1. انقر بزر الماوس الأيمن فوق TeamFoundation، ثم أشر إلى جديد ، ثم انقر فوق مفتاح .

   2. قم بتسمية المفتاح RequestSettings.

   3. انقر بزر الماوس الأيمن فوق RequestSettings، أشر إلى جديد ثم انقر فوق قيمة DWORD .

   4. قم بتسمية القيمة الجديدة الفترة المهملة الافتراضية .

5. انقر بزر الماوس الأيمن علي فترة المهلة الافتراضية و اختر تعديل.

6. في بيانات القيمة ، اكتب فترة المهلة بالمللي ثانية ثم انقر فوق عشري .

   على سبيل المثال، لزيادة فترة المهلة ل 30 دقائق، نوع 1800000. لتغيير المهلة نقطة إلى 10 دقائق، اكتب 600000.

7. انقر فوق موافق.

8. من القائمة ملف، انقر فوق إنهاء.

مثال

يزيل الأمر التالي كافة المكونات المقترنة بمشروع الفريق StoreFront على Team Foundation Serverخادم AdventureWorks1 في مجموعة المشروع Collection1 ومن مستكشف الفريق.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/Collection1 StoreFront

راجع أيضًا:

المهام

كيفية: الاتصال مع فريق العمل Access المشاريع في فريق البنية الأساسية لعرض برامج الملقم

كيفية: إنشاء مشروع فريق

موارد أخرى

إدارة الأذونات

تكوين موارد لدعم فريق المشاريع

استخدام أدوات سطر الأوامر في خادم Team Foundation