أمر إحضار
يسترد نسخة للقراءة فقط لملف من Team Foundation Server الي مساحة العمل ويقوم بإنشاء مجلدات على قرص لاحتواءه.
الأذونات المطلوبة.
لاستخدام الأمر get ايجب أن يكون لديك مجموعة الأذونات المقروءة معينة علي السماح بالنسبة لكل عنصر تم استرداده و يجب عليك إما ان تملك مساحة العمل الوجهة أو يكون لديك إذن مساحات العمل المسؤولة العمومية. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.
tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/noprompt]
المعلمات
الوسيطة |
الوصف |
|---|---|
Itemspec |
لاسترداد ملف أو مجلد إذا لم يتم توفير itemspec Team Foundation Server ينفذ عملية الحصول العودية لمساحة العمل الحالية. |
Versionspec |
القيمة الموفرة بواسطة المستخدم للخيار /version . للحصول على مزيد من المعلومات حول كيفية قيام Team Foundation Server بتحليل مواصفات الإصدار لتحديد أي من العناصر داخل النطاق الخاص به, راجع بناء جملة سطر الأوامر (التحكم بالإصدار). |
الخيار |
الوصف |
|---|---|
/version |
مواصفات اصدار اختيارية . versionspec هو إصدار العنصر الذي تريد استرداده. يمكنك تحديد إصدار بواسطة:
|
/all |
يفرض استرداد كافة الملفات وليس فقط تلك القديمة. |
/overwrite |
الكتابة فوق الملفات الصالحة للكتابة التي لا تكون قيد السحب. |
/force |
يدمج /all و /overwrite. |
/preview |
يعرض ما قد يحدث، بدون تنفيذ العملية Get بالفعل. |
/recursive |
بشكل متكرر يقوم باسترداد كافة العناصر التي تطابق itemspec الخاص بك . |
/noprompt |
منع أية مربعات حوار التي قد يتم عرضها أثناء هذه العملية. |
ملاحظات
الأمر get يقوم باسترداد العناصر من الملقم إلى مساحة العمل. إذا لم يتم توفير اصدار أخر يتم استرداد أحدث خادم .
إذا كنت تعمل في بيئة تطوير فريق get هو الأمر الأكثر استخدامًا لأن الحصول على كل ملف في المشروع الحالي يتزامن مع الفريق ويتأكد من أن لديك أحدث نسخة من العمل المشترك. الأمرget لا يؤدي إلى الكتابة فوق الملفات التي قمت بسحبها في الدليل المحلي كلما تنفذ الأمر get في بيئة عمل متعاونة كلما زادت الملفات المحلية للفريق الخاص بك. هذا بسبب أن العملية get تملأ مساحة العمل المحلية بالتغييرات التي تم التحقق منها إلى الملقم بواسطة teammates. إذا كنت تحتفظ بمساحة العمل الخاصة بك محدّثة عن طريق إجراء العملية get عند ظهور إعلام "إيداع" (من تنبيهات المشروع على سبيل المثال) ، يمكنك بسرعة حل الاختلافات بين إصدار مشروع و إصدار خادم المشروع. يمكنك تجنب إجراء تغييرات قد لا تكون سهلة الإصلاح مع الملقم عند إيداع التغييرات المعلقة.
أثناء عملية get إذا كان إصدار مساحة العمل هو نفس إصدار الملقم المطلوب لا يحل Team Foundation Server محل الملف على قرص إلا إذا تم تحديد الخيار /all. يمكنك استخدام الخيار /overwrite لفرض الكتابة فوق إصدار مساحة العمل الحالي مع إصدار ملقم محدد لاستعادة مساحة العمل الخاصة بك إلى حالة متناسقة عندما تصبح غير قابلة للادارة مثل ما يحدث أحياناً عند حذف أو بطريق الخطأ الكتابة فوق ملفات متعددة على قرص. عند تمرير الخيار /force ، يقوم Team Foundation Server بالكتابة فوق كافة العناصر التي هي قيد السحب في مساحة العمل مع أحدث اصدار للملقم إلا إذا قمت بتوفير اصدار معين.
عند إجراء عملية get ، يقوم Team Foundation Server بحذف أي ملفات تم إيداعها من مساحة العمل المحلية التي تم حذفها من الملقم بعد آخر مرة قمت بمزامنة مساحة العمل الخاصة بك إلى إصدار الملقم. يتم تغيير موقع الملفات التي تم إعادة تسميتها أو نقلها على الملقم على القرص لتطابق التغييرات على الخادم.
يمكنك استخدام الخيار /preview لإصدار الأمر get بدون إجراء التحديثات لمساحة العمل المحلية لرؤية ما قد يحدث اذا كنت ستقوم بالتنفيذ الفعلي لعملية الحصول.
لا تنفذ عملية السحب بعملية الحصول على الأحدث على الملفات التي هي قيد السحب
كـمطور يعمل في مساحة عمل ،فإنك تكون معزول عن التغييرات التي أجريت بواسطه المطورين الاخريين. لقبول التغييرات من مطورين أخرين بواسطة تنفيذ العملية get بالشكل المناسب، فانه بوسعك فعل ذلك. وبشكل مثالي، يمكنك تحديث التكوين الكامل للملفات محكمة الاصدار وليس فقط واحد أو اثنين من الملفات بسبب ان التغييرات في ملف واحد تستند عادةً على التغييرات الموافقة في ملفات أخرى. يجب التأكد من أن لديك لقطة متناسقة للملفات محكمة الاصدار التي يمكن أن يتم إنشاؤها واختبارها.
ولهذا عملية السحب لا تقوم بتنفيذ عملية الحصول علي الأحدث على الملفات التي هي قيد السحب. تحديث ملف واحد تم سحبه قد يتسبب في انتهاك اللقطة المتناسقة و قد يمنحك تكوين ملفات محكمة الإصدار التي لا يمكن إنشاءها أو اختبارها. كبديل يفرض Team Foundation Server عليك تنفيذ عملية الحصول على الأحدث في نقطة قبل التدقيق في التغييرات بحيث عند محاولتك إيداع التغييرات كما لم يكن لديك أحدث نسخة تتم مطالبتك بحل التعارضات من خلال مربع الحوار.
يمكنك أيضاً تكوين Team Foundation Server للحصول تلقائياً على أحدث الاختيار. لمزيد من المعلومات، راجع ضبط اعدادات السحب.
للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF، راجع TF أداة سطر أوامر.
عملية الإحضار
عند إصدارك الأمر get لعنصر من الملقم وهذا العنصر قيد السحب بالفعل في مساحة العمل الخاصة بك و قد تم تغيير إصدار الملقم فستتم مطالبتك بحل تعارضات الملف بين مساحة العمل "و" إصدار الملقم المسترد . لمزيد من المعلومات، راجع أمر حل.
أمثلة
المثال التالي يقوم باسترداد أحدث اصدار من cs 314. من الملقم. إذا كان لديك تغييرات معلقة مقابل 314.cs يبدأ Team Foundation Server عملية الحل التي تساعدك في تحديد كيفية معالجة التعارضات.
C:\projects>tf get 314.cs
يسترد المثال التالي الاصدار 8 من 1256.cs من الملقم.
ملاحظة
استخدام 1256.cs;8يكافئ استخدام 1256.cs;C8. افتراضياً، يُستخدم اصدار changeset إذا قمت بتحديد عدد فقط بعد الفاصلة المنقوطة.
C:\>tf get 1256.cs;8
يقوم المثال التالي باسترداد الإصدارات الأحدث من كافة العناصر uncloaked من مجلد الملقم والمجلدات الفرعية إلى الدليل C:\projects وإنشاء المجلدات المحلية حيث تكون مطلوبة. للحصول على مزيد من المعلومات حول كيفية cloak و uncloak المجلدات, راجع أمر workfold.
C:\projects>tf get
الأمثلة التالية توفر طرق بديلة لاسترداد الإصدار 1256.cs تم إيداعها ب changeset 1999.
c:\projects>tf get /version:C1999 1256.cs
—أو—
c:\projects>tf get 1256.cs;C1999
يسترد المثال التالي اصدار كافة العناصر uncloaked من الخادم كما أنها موجودة في الملقم عند إنشاء changeset 271.
c:\projects>tf get /version:C271
يقوم المثال التالي باسترداد build42 المسماة كـ “ build42." وهذا يطابق مساحة العمل الخاصة بك بالتسمية طالما لم توجد تغييرات معلقة. يتم إزالة أية ملفات غير موجودة في التسمية من القرص المحلي.
c:\projects>tf get /version:Lbuild42
يسترد المثال التالي الاصدار الذي على الملقم من وقت وتاريخ محدد.
c:\projects>tf get /version:D2008-01-21T16:00
راجع أيضًا:
المهام
كيفية: الحصول على المصدر لـ Project الفريق الخاص بك
كيفية: cloak و Uncloak مجلدات في مساحة عمل
المرجع
أمر الاستعادة من الحافظة(Unshelve)