أمر إتلاف

استخدم الأمر tf destroy لإتلاف أو حذف نهائياً، ملفات إصدار التحكم من التحكم بالإصدار Team Foundation.

لا يمكن عكس الإجراء إتلاف. يجب عدم إتلاف الملفات التي لا تزال هناك في حاجة إليها. في بعض الأحيان يجب عليك تنظيف أنظمة التحكم بالإصدار. على سبيل المثال، عند إصابة بعض الملفات بفيروس كمبيوتر لديك يجب عليك إزالتها نهائياً من إصدار عنصر التحكم.

قبل تشغيل tf destroy بدون الخيار /keephistory ، نوصي أولاً بحذف الملفات التي تريد إتلافها. لمزيد من المعلومات، راجع كيفية: حذف الملفات والمجلدات من التحكم الإصدار.

بعد حذف الملفات ، يمكنك مزامنة المستودع Team Foundation. وإلا المستودع لن يتم مزامنته مع العناصر المحطمة.

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

لاستخدام الأمر destroy يجب أن تكون منتمي لمجموعة الأمان مسؤولي أساس الفريق . لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>…<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt]

المعلمات

الوسيطة	الوصف
itemspec1 [itemspec2…itemspecN]	تعيين مسار الملقم من الملف أو المجلد المراد اتلافه. استخدام عدة قيم itemspec لحذف عناصر متعددة. على سبيل المثال، tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3. المسارات المحلية غير معتمدة.
versionspec	يوفر إصدار مثل C58 للخيارات /keephistory أو /stopat . تكون القيم المسموح بها التاريخ، التلميحة , أو مجموعة تغييرات معينة. للحصول على مزيد من المعلومات حول كيفية قيام Team Foundation بتحليل مواصفات الإصدار لتحديد أي من العناصر داخل النطاق الخاص به, راجع بناء جملة سطر الأوامر (التحكم بالإصدار).

الخيار	الوصف
/keephistory	اختياري. تعيّن انه يتم الاحتفاظ بتاريخ الملف حتى اذا تم إتلاف محتوياته. و لا يمكن تعيين هذا مع الخيار /preview,
/stopat	اختياري. يمكن استخدامها فقط إذا كان /keephistory محدد أيضاً. تعيّن إصدار الملف للملف و الملفات التي تتبعها بعد ذلك, والتي يتم الاحتفاظ بالمحفوظات . الإصدار الافتراضي من أجل /stopat هو تلميح (T) من أجل أحدث الإصدار المحدد لعنصر. لا يمكنك استخدام التسمية أو قيم مساحة عمل versionspec لتحديد عنصر لـلخيار /stopat .
/preview	يعرض في نافذة موجه الأوامر الملفات التي قد تتلف. عند تشغيل tf destroy في وضع المعاينة ، لا يتم فعلياً إتلاف الملفات. ملاحظة يعرض النص في إطار موجّه الأوامر الكلمة "Destroyed" مع كل ملف قد يتلف.ومع ذلك، لا يتلف فعلياً الملف عند استخدام الخيار /preview .
/startcleanup	يفرض على عملية تنظيف محتوى الملف للبدء بمجرد انتهاء حذف المحتوى. إذا لم يحدد المستخدم /startcleanup ، تحدث عملية تنظيف محتوى المحذوف عند مسح صيانة قاعدة البيانات كافة الملفات التي لم تعد الإشارة اليها بواسطة Team Foundation Server. بشكل افتراضي ، يتم جدولة التنظيف للتشغيل مرة كل يوم .
/noprompt /i	تعين التي إلى إتلاف ملفات هو غير التبادلي. /iهو اسم مستعار لـ/noprompt.

ملاحظات

عند استخدام tf destroy لإتلاف ملفات التحكم بالإصدار ،يتلقى طبقة التطبيق ل Team Foundation Server طلب الإتلاف و التحقق لمعرفة ما إذا كنت عضواً في مجموعة الأمان مسؤولي أساس الفريق . إذا لم تكن عضواً النظام يعرض مربع الحوار رسالة خطأ تخبرك أنه ليس لديك الأذونات الكافية لتنفيذ العملية.

بعد تحقق النظام من الأذونات الخاص بك ، يتم تشغيل الأمر إتلاف. يحذف هذا الأمر كافة مراجع الملف ، مجموعة التغييرات ، و التغييرات المعلقة. يحدث الإتلاف الفعلي للملف ، والذي هو عملية الحذف الدائمة , في المرة التالية التي المحتوى لم يعد له مرجعية بواسطة Team Foundation Server يتم تنظيفه. يمكنك أيضاً تحديد الخيار /startcleanup لنظيف الملفات مباشرة بعد تشغيل tf destroy .

اذا قمت بتشغيل tf destroy دون تعيين /i و /preview ، يعرض النظام على وحدة التحكم المطالبة Yes أو No لكل قيمة filespec . أو، يمكنك تحديد Yes to all. إذا لم تحدد /keephistory ، تتم مطالبتك بواسطة ‏‫نص‬ تفاعلي الذي يحذر من التغييرات المعلقة ، إذا كانت موجودة. يشير النص التفاعلي الي /preview إذا كنت تريد المزيد من المعلومات حول التغييرات. إذا حددت /keephistory فستتم مطالبتك أيضًا بواسطة النص Yes ، No, أو All . إذا قمت بتحديد Yes أو All, تبدأ عملية الإتلاف وتظهر مسارات الخادم للعناصر المحذفة في إطار موجه الأوامر.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: …

إذا حددت قيمة versionspec كتلميح ، تتضمن مسارات الخادم المعروضة في موجه الأوامر معرفات الحذف . على سبيل المثال، قد تظهر 123 X في نافذة موجه الأوامر.

إذا استخدمت الامر**/preview** لن يتم إتلاف الملفات و لكن يعرض نص سطر الأوامر الملفات التي سيتم إتلافها . على سبيل المثال، إذا كتبت على سطر الأوامر, tf destroy /preview $/Test1/MyProject/MyProject/Program.cs ، يعرض إطار الأمر هذا النص:

إتلاف: $/Test1/MyProject/MyProject/Program.cs

ومع ذلك، لا يتلف فعلياً الملف لانك استخدمت الخيار /preview .

للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF , راجع TF أداة سطر أوامر.

تأثيرات /keephistory على "عمليات التحكم بالإصدار الأخرى"

إذا حددت الخيار /keephistory للاحتفاظ بالمحفوظات للملفات التالفة, يتم التعامل مع الملفات كما الإتلاف بواسطة العمليات التالية التحكم بالإصدار Team Foundation :

• تغيير المحتوى عند محاولة تغيير محتوى الملف التالف على سبيل المثال تحرير أو تفريع ، يصدر النظام رسالة خطأ تشير إلى إتلاف المحتوى.

• تفريع ، دمج، أو استعادة من الحافظة إذا حاولت التفرع أو الدمج او الاستعادة من الحافظة للعناصر التالفة ، يصدر النظام رسالة خطأ تنص على محتويات العناصرالتالفة.

إتلاف العناصر المحذوفة مسبقاً

إذا تم حذف عنصر مسبقاً, يتم إرفاق معرف حذف له و النتائج في تغيير اسم ملف.

أمثلة

الوصف

المثال التالي يحذف الملف a.cs بشكل دائم.

الرمز

C:\pi\ws1>tf destroy $/proj/pi/a.cs

الوصف

يحذف المثال التالي المجلد aFolder ، اكتب في سطر الأوامر:

الرمز

C:\tf delete $/MyTeamProject/aFolder

الوصف

لإتلاف العنصر المحذوف aFolder ، يجب عليك كتابة سطر الأوامر:

الرمز

tf destroy $/MyTeamProject/sFolder;x123

حيث أن x 123 هو معرّف الحذف.

راجع أيضًا:

المهام

إتلاف الملفات المتحكَّم بإصدارها

المبادئ

العمليات المتوفرة فقط من سطر الأوامر ( الإصدار التحكم لفريق الأساس)

موارد أخرى

TF أداة سطر أوامر