مشاركة عبر

WindowsMachineFileCopy@2 - مهمة نسخ ملف جهاز Windows v2

  • مقالة

استخدم هذه المهمة لنسخ الملفات إلى أجهزة Windows البعيدة.

بناء الجملة

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

الإدخالات

SourcePath - مصدر
string. مطلوب

المسار إلى الملفات المراد نسخها. يحدد المسار المطلق للمجلد المصدر أو الملف على الجهاز المحلي أو مشاركة UNC، مثل c:\fabrikamfiber أو \\fabrikamshare\fabrikamfiber. يمكنك استخدام متغيرات النظام المعرفة مسبقا، مثل $(Build.Repository.LocalPath) (مجلد العمل على كمبيوتر العامل)، مما يسهل تحديد موقع البيانات الاصطناعية للبنية على الكمبيوتر الذي يستضيف عامل التشغيل التلقائي.


MachineNames - الات
string. مطلوب

يحدد قائمة مفصولة بفواصل لعناوين IP للجهاز أو FQDNs، بما في ذلك رقم المنفذ اختياريا.
على سبيل المثال: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 يمكنك أيضا تحديد متغير الإخراج للمهام الأخرى، على سبيل المثال $(variableName)، أو يمكنك استخدام اسم مجموعة موارد Azure.


MachineNames - الات
string.

يحدد قائمة مفصولة بفواصل لعناوين IP للجهاز أو FQDNs، بما في ذلك رقم المنفذ اختياريا. على سبيل المثال: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. يمكنك أيضا تحديد متغير الإخراج للمهام الأخرى، على سبيل المثال $(variableName)، أو يمكنك استخدام اسم مجموعة موارد Azure.


AdminUserName - تسجيل الدخول مسؤول
string. مطلوب

يحدد اسم المستخدم لمجال أو حساب إداري محلي على المضيف (المضيفين) الهدف. يتم دعم تنسيقات مثل domain\username واسم المستخدم واسم الجهاز/اسم المستخدم . تنسيقات UPN، مثل username@domain.com، وحسابات النظام المضمنة، مثل NT Authority\System، غير مدعومة.


AdminUserName - تسجيل الدخول مسؤول
string.

يحدد اسم المستخدم لمجال أو حساب إداري محلي على المضيف (المضيفين) الهدف. يتم دعم تنسيقات مثل domain\username واسم المستخدم واسم الجهاز/اسم المستخدم . تنسيقات UPN، مثل username@domain.com، وحسابات النظام المضمنة، مثل NT Authority\System، غير مدعومة.


AdminPassword - كلمه المرور
string. مطلوب

يحدد كلمة المرور لتسجيل دخول المسؤول للأجهزة المستهدفة. يتم قبول المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار، مثل $(passwordVariable)، . يمكنك وضع علامة على المتغير على أنه secret لتأمينه.


AdminPassword - كلمه المرور
string.

يحدد كلمة المرور لتسجيل دخول المسؤول للأجهزة المستهدفة. يتم قبول المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار، مثل $(passwordVariable)، . يمكنك وضع علامة على المتغير على أنه secret لتأمينه.


TargetPath - مجلد الوجهة
string. مطلوب

يحدد المسار المحلي على الأجهزة الهدف أو مسار UNC يمكن الوصول إليه لنسخ الملفات من المصدر، مثل d:\fabrikam أو \\fabrikam\Web.


CleanTargetBeforeCopy - هدف نظيف
boolean. القيمة الافتراضية: false.

حذف كافة الملفات الموجودة في المجلد الهدف قبل نسخ الملفات الجديدة إليه.


CopyFilesInParallel - نسخ الملفات بالتوازي
boolean. القيمة الافتراضية: true.

نسخ الملفات إلى جميع الأجهزة المستهدفة بالتوازي، والتي يمكن أن تسرع عملية النسخ.


AdditionalArguments - وسيطات إضافية
string.

يحدد وسيطات RoboCopy الإضافية التي يتم تطبيقها عند نسخ الملفات، مثل /min:33553332 /l.


خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

استخدم هذه المهمة لنسخ ملفات التطبيقات والبيانات الاصطناعية الأخرى، مثل البرامج النصية PowerShell ووحدات PowerShell-DSC النمطية، المطلوبة لتثبيت التطبيق على أجهزة Windows. ويستخدم RoboCopy، الأداة المساعدة لسطر الأوامر التي تم إنشاؤها للنسخ السريع للبيانات.

لماذا أحصل على خطأ النظام 53 عند استخدام هذه المهمة؟

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

ما الجديد في الإصدار 2.0

  • تتم إضافة دعم الوكيل.
  • تمت إزالة دعم أجهزة DTL القديمة.

المتطلبات

المتطلب الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب بلا
القدرات لا تلبي هذه المهمة أي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 1.104.0 أو أحدث
فئة المهمة نشر