أمر القفل (Lock)
قفل أو إلغاء قفل ملف أو مجلد لرفض أو استعادة حق المستخدمين لسحب عنصر لتحريره في مساحة عمل مختلفة أو إيداع تغييرات معلقة لعنصر من مساحة عمل مختلفة.
الأذونات المطلوبة.
لاستخدام أمر lock يجب أن يكون لديك مجموعة الأذونات قفل(Lock) معيَّنة إلى السماح . يُحتاج إلى أن يكون الإذن "إلغاء قفل تغييرات المستخدم الآخر" لمجموعة الأذونات معيَّناً إلى السماح لإزالة قفل تم إجراؤه من قبل مستخدم آخر إذا لم يكن لديك إذن الكتابة لمساحة العمل الخاصة بهذا المستخدم. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/server:servername] [/recursive]
المعلمات
الوسيطة |
الوصف |
|---|---|
itemspec |
يعرّف الملف أو المجلد للقفل أو إلغاء القفل. للحصول على مزيد من المعلومات حول كيفية تحليل Team Foundation لمواصفات العناصر (itemspecs) لتحديد العناصر التي كانت داخل النطاق, راجع خيارات سطر الأوامر. |
workspacename |
القيمة الموفرة بواسطة المستخدم للخيار /workspace . |
servername |
القيمة الموفرة بواسطة المستخدم للخيار /server . مثال: http://teamfoundation2:8080/. |
الخيار |
الوصف |
|---|---|
/lock |
تحدد نوع القفل أو تزيل القفل من على عنصر. لمزيد من المعلومات، راجع فهم أنواع التأمين. خيارات القفل
|
/workspace |
تعين اسم مساحة عمل مختلفة تقوم فيها بتطبيق القفل. بشكل افتراضي، يتم تطبيق القفل في مساحة العمل التي أنت فيها حالياً. |
/server |
تعين عنوان URL الخاص التحكم بالإصدار Team Foundationالملقم إلى بوصة العمل هذا الخيار مطلوب إذا تم استدعاء الأمر من دليل غير معين لمساحة العمل. |
ملاحظات
يمكنك استخدام أمر القفل لتجميد إصدار الخادم التحكم بالإصدار Team Foundation لعنصر مؤقتا بحيث يمكنك إيداع تغيير معلق دون الحاجة لحل أية تعارضات في الدمج. إذا كنت تريد منع الوصول بشكل دائم لأحد العناصر في الخادم التحكم بالإصدار Team Foundation، يجب عليك استخدام بدلاً من ذلك أمر الأذن.
ملاحظة
كمجاملة لأعضاء الفريق الخاص بك، ابلغهم عند إجراء قفل علي عنصر، تشرح لماذا تقوم بإجراء ذلك و تقدِّر متي تخطط لإزالة القفل، إن أمكن.
للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF، راجع TF أداة سطر أوامر.
كيفية قفل عنصر
يمكنك قفل عنصر باستخدام الأمر قفل أو عن طريق تحديد خيار قفل أثناء تنفيذ عدة أوامر أخرى من الأداة المساعدة لسطر الأوامر tf التي تتضمن:
للإضافة و التفريع، يتم وضع القفل على مساحة الاسم حيث يتم إنشاء العنصر. القفل الذي يوضع مع إعادة التسمية يطبق كلا من مساحات الأسماء القديمة والجديدة. لمزيد من المعلومات، راجع كيفية: تأمين و إلغاء تأمين الملفات أو المجلدات.
أنواع القفل
يوفر Team Foundation نوعين من عمليات القفل: checkin(الإيداع) وcheckout(السحب)
قفل الإيداع أقل تقييداً من قفل السحب. عندما تقوم بتطبيق قفل إيداع يمكن للمستخدمين الاستمرار في إجراء تغييرات محلية للعنصر في مساحات عمل أخرى. لا يتم إيداع التغييرات حتى تقوم بإزالة قفل الإيداع بشكل صريح من مساحة العمل.
قفل السحب أكثر تقييداً من قفل الإيداع. عندما تقوم بتطبيق قفل السحب لملف أو لمجلد يتم التحكم فيه بالإصدار، يمكن للمستخدمين إما سحب الملف لتحرير أ إيداع تغييرات معلقة موجودة سابقاً. لا يمكنك الحصول على قفل سحب إذا كانت هناك حالياً أي تغييرات معلقة للعنصر.
للحصول على مزيد من المعلومات حول متى يطبِّق قفل السحب ومتى يطبِّق قفل الإيداع, راجع فهم أنواع التأمين.
كيفية عمل القفل
إذا كان لديك ملف تم سحبه عندما قمت بقفله, يتم تعديل الحالة الخاصة به لتحتوي على نوع القفل الجديد. إذا لم يتم سحب الملفات، يتم إضافة تغيير قفل لمجموعة التغييرات المعلقة من مساحة العمل. بعكس أمر checkout ، lock لا يجعل الملف قابل للتحرير تلقائياً.
الأقفال على المجلدات المتداخلة ضمنيًا. في حالة وضعك قفل للمجلد ،ليس عليك قفل الملفات التي داخل المجلد إلا إذا كنت ترغب في تطبيق قفل سحب أكثر تقييدًا إلى ملف في مجلد به قفل إيداع.
إلغاء قفل عنصر
يمكنك إلغاء قفل عنصر مؤمن باستخدام الخيار none . بالإضافة إلى ذلك، يقوم Team Foundation بإلغاء قفل عنصر تلقائياً عند إيداعك تغييرات معلقة في مساحة العمل.
يمكنك معرفة أي الملفات مقفلة في الخادم التحكم بالإصدار Team Foundation و من الذى قام بقفلها باستخدام أمر الحالة.
أمثلة
المثال التالي يمنع المستخدمين الآخرين من سحب 314.cs.
c:\projects>tf lock /lock:checkout 314.cs
المثال التالي يمنع المستخدمين الآخرين من إيداع تغييرات إلى 1256.cs ولكن يتيح لهم التحقق منها في مساحات العمل الخاصة بهم.
c:\projects>tf lock /lock:checkin 1256.cs
المثال التالي يمنع المستخدمين الآخرين من تغييرات معلقة على أي عنصر من العناصر في مجلد src / في الخادم التحكم بالإصدار Team Foundation.
c:\projects>tf lock /lock:checkout $/src
المثال التالي يقوم بإلغاء قفل ويجعل كافة الملفات في مجلد خادم التحكم بالإصدار Team Foundationsrc / متوفرة للسحب و الإيداع بواسطة المستخدمين الآخرين.
c:\projects>tf lock /lock:none src/
راجع أيضًا:
المرجع
بناء جملة سطر الأوامر (التحكم بالإصدار)