أمر ‏‫إعادة التسمية (تحكم إصدار أساس الفريق)

أمر rename يقوم بتغيير اسم أو مسار الملف أو المجلد. يمكنك استخدام أمر rename أو الأسماء المستعارة move أو ren لنقل ملف أو مجلد إلى موقع جديد.

ملاحظة

نتائج هذا الأمر لا تنعكس في الخادم التحكم بالإصدار Team Foundation حتى تقوم بإجراء عملية الإيداع . لمزيد من المعلومات، راجع كيفية: إيداع التغييرات المعلقة.

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

لاستخدام أمر rename يجب أن تعين مجموعة الأذونات السحب لـسماح. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.

tf rename [/lock:(none|checkout|checkin)] olditem newitem

المعلمات

الوسيطة	الوصف
olditem	الاسم الأصلي و مسار الملف أو المجلد التي ينبغى إعادة تسميته. يمكنك تحديد مسار مساحة عمل محلية مثل C:\myfiles\314.cs أو مسار خادم التحكم بالإصدار Team Foundation مثل $ / myfiles/314.cs.
newitem	الاسم الجديد للملف أو المجلد. يمكنك استخدام هذا لتحديد خادم محلي مختلف أو موقع مسار خادم التحكم بالإصدار Team Foundation.

الخيار

الوصف

/lock

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

ملاحظات

يمكنك استخدام الأمر rename فى الأداة المساعدة لسطر الأوامر tf لنقل أو إعادة تسمية "عنصر متحكم فيه على أساس الإصدار" في مساحة العمل الخاصة بك. استخدام أمر rename لنقل ملفات متعددة عن طريق تحديد أحرف البدل. تتوفر القدرة علي إعادة تسمية عنصر تحكم الإصدار لعدة ملفات أو مجلدات فقط من سطر الأوامر.

استخدم إعادة التسمية لتقوم بما يلي:

• Rename theolditemإلى thenewitem, such كـtf rename 314.cs 315.cs.

• انقل olditem إلى موقع جديد في خادم التحكم بالإصدار Team Foundation عن طريق توفير newitem الذي يختلف مساره عن olditem, مثل  tf rename 314.cs ..\newdir\314.cs

إذا قمت بتوفير newitem الذي يحدد مجلدا غير موجود، أمر rename ينشئ مجلد الوِجهة. إذا كان newitem مجلد، يصبح olditem تابع لـ newitem.

لا يمكنك إعادة تسمية عنصر إذا:

• كنت قد قمت بحذفه بالفعل قبل إيداعه في نفس مساحة العمل.

• كان الاسم الجديد موجود بالفعل في الخادم التحكم بالإصدار Team Foundation وليس مجلدا.

• كنت قد قمت بالفعل بالإضافة ، التفريع أو إعادة تسمية إيداع التعليق للعنصر.

• تك تعيين العنصر في مساحة العمل ولكنه غير متوفر على القرص المحلي.

• العنصر محجوب.

يمكنك إعادة تسمية العنصر لإضافة أي ملف آخر بنفس الاسم المعلقة إيداع لكن لا يمكن إعادة تسمية العنصر الذي تم branched لكن لم يتم إيداعه. عند إعادة تسمية ملف يحتوي على معلّقة عمليات التحرير، يتم حفظ عمليات التحرير.

لا يمكن إعادة تسمية أحد العناصر التي تم تعيينها بشكل صريح دون تغيير التعيين أولاً. على سبيل المثال، إذا كان هناك تعيين مجلد من $/ProjectX/MyApp إلى c:\MyApp ، لا يمكنك إعادة تسمية اسم التطبيق. يمكنك إعادة تسمية العناصر ضمن MyApp ولكن ليس MyApp نفسه.

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

أمثلة

المثال التالي يقوم بتغيير الاسم من 314.c إلى 1254. c.

c:\projects>tf rename  314.c  1254.c

المثال التالي يقوم بإعادة تسمية 314.c إلى 1254.c ونقله إلى المجلد newdir.

c:\projects>tf rename 314.c ..\newdir\1254.c

المثال التالي يقوم بتغيير Form1.vb إلى MainPage.vb و تطبيق قفل عليها.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin

راجع أيضًا:

المهام

كيفية: نقل إعادة تسمية وحذفه يتحكم فيه الإصدار الملفات والمجلدات

المرجع

بناء جملة سطر الأوامر (التحكم بالإصدار)

اضافه أمر

أمر حذف (تحكم اصدار Team Foundation)

أمر إحضار

المبادئ

فهم أنواع التأمين

التغييرات المعلقة

موارد أخرى

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