AzureFileCopy@1 - مهمة نسخ ملف Azure v1

نسخ الملفات إلى Azure Blob Storage أو الأجهزة الظاهرية.

ملاحظة

لا تدعم هذه المهمة مصادقة Azure Resource Manager مع اتحاد هوية سير العمل.

بناء الجملة

# Azure file copy v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArguments: # string. Additional Arguments. 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

الإدخالات

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

حدد المسار المطلق للمجلد المصدر أو الملف على الجهاز المحلي أو مشاركة UNC. يجب أن ترجع القيمة أو التعبير المحدد إما اسم مجلد واحد أو اسم ملف.

azureConnectionType - نوع اتصال Azure
الاسم المستعار للإدخل: ConnectedServiceNameSelector. string. القيم المسموح بها: ConnectedServiceName (Azure Classic)، ConnectedServiceNameARM (Azure Resource Manager). القيمة الافتراضية: ConnectedServiceNameARM.

حدد نوع اتصال Azure.

azureClassicSubscription - اشتراك Azure Classic
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName.

حدد اشتراك Azure Classic الهدف.

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceNameARM. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameARM.

حدد اشتراك Azure Resource Manager الهدف.

Destination - نوع الوجهة
string. مطلوب القيم المسموح بها: AzureBlob (Azure Blob)، AzureVMs (أجهزة Azure الظاهرية).

حدد نوع الوجهة المراد استخدامه لنسخ الملفات.

classicStorage - حساب التخزين الكلاسيكي
الاسم المستعار للإدخل: StorageAccount. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName.

حدد حساب تخزين كلاسيكي موجود مسبقا. هذا هو حساب التخزين المستخدم كوسيط لنسخ الملفات إلى أجهزة Azure الظاهرية.

storage - حساب تخزين RM
الاسم المستعار للإدخل: StorageAccountRM. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameARM.

حدد حساب تخزين ARM موجود مسبقا. هذا هو حساب التخزين المستخدم كوسيط لنسخ الملفات إلى أجهزة Azure الظاهرية.

ContainerName - اسم الحاوية
string. مطلوب عند Destination = AzureBlob.

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

لإنشاء دليل ظاهري داخل الحاوية، استخدم إدخال بادئة Blob.

مثال: بالنسبة للموقع https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/الهدف ، حدد اسم mycontainer الحاوية وبادئة Blob: vd1/vd2.

BlobPrefix - بادئة كائن ثنائي كبير الحجم
string. ‏‏اختياري. استخدم عندما Destination = AzureBlob.

حدد بادئة يمكن استخدامها لتصفية الملفات.

مثال: يمكنك إلحاق رقم بناء لتصفية الملفات من جميع الكائنات الثنائية كبيرة الحجم بنفس رقم البناء.

مثال: إذا قمت بتحديد بادئة myvd1Blob ، يتم إنشاء دليل ظاهري داخل الحاوية. يتم نسخ الملفات من المصدر إلى https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - خدمة السحابة
الاسم المستعار للإدخل: EnvironmentName. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

حدد اسم خدمة السحابة الهدف.

resourceGroup - مجموعة الموارد
الاسم المستعار للإدخل: EnvironmentNameRM. string. مطلوب عند ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

حدد اسم مجموعة الموارد الهدف.

ResourceFilteringMethod - تحديد الأجهزة حسب
string. ‏‏اختياري. استخدم عندما Destination = AzureVMs. القيم المسموح بها: machineNames (أسماء الأجهزة)، tags. القيمة الافتراضية: machineNames.

حدد اسم مضيف الجهاز الظاهري أو علامة تحدد مجموعة فرعية من الأجهزة الظاهرية في مجموعة موارد. يتم دعم العلامات للموارد التي تم إنشاؤها عبر Resource Manager Azure فقط.

MachineNames - معايير التصفية
string. ‏‏اختياري. استخدم عندما Destination = AzureVMs.

قم بتوفير قائمة بأسماء مضيفي جهاز Azure الظاهري مثل ffwebأو ffdbأو علامات مثل Role:DBو WebOS:Win8.1و.

ملاحظة: تتضمن المحددات الصالحة للعلامات و(الفاصلة) :(colon) ;(semicolon). عند توفير علامات متعددة، سيتم تشغيل المهمة فقط في الأجهزة الظاهرية التي تحتوي على العلامات المحددة. بشكل افتراضي، يتم تشغيل المهمة في جميع الأجهزة الظاهرية.

vmsAdminUserName - تسجيل الدخول مسؤول
string. مطلوب عند Destination = AzureVMs.

حدد اسم المستخدم لحساب مسؤول جهاز Azure الظاهري.

vmsAdminPassword - كلمه المرور
string. مطلوب عند Destination = AzureVMs.

حدد كلمة المرور لحساب مسؤول جهاز Azure الظاهري.

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

TargetPath - مجلد الوجهة
string. مطلوب عند Destination = AzureVMs.

حدد المسار المحلي على الأجهزة الظاهرية الهدف لنسخ الملفات من المصدر.

يتضمن الإدخال الصالح متغيرات البيئة مثل $env:windir\BudgetIT\Web.

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

توفير وسيطات إضافية لذلك AzCopy.exe سيتم تطبيقها عند التحميل إلى الكائنات الثنائية كبيرة الحجم أو الأجهزة الظاهرية مثل . /NC:10

enableCopyPrerequisites - تمكين نسخ المتطلبات الأساسية
boolean. ‏‏اختياري. استخدم عندما ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. القيمة الافتراضية: false.

عند التمكين، يستخدم شهادة موقعة ذاتيا لتكوين مستمع إدارة Windows عن بعد (WinRM) على المنفذ 5986 بدلا من بروتوكول HTTPS. مطلوب لتنفيذ عمليات النسخ على أجهزة Azure الظاهرية. إذا كانت الأجهزة الظاهرية الهدف تستخدم موازن تحميل، فكون قواعد NAT الواردة للمنفذ الهدف (5986). ينطبق فقط على أجهزة ARM الظاهرية.

CopyFilesInParallel - نسخ بالتوازي
boolean. ‏‏اختياري. استخدم عندما Destination = AzureVMs. القيمة الافتراضية: true.

يؤدي قبول الإعداد الافتراضي إلى نسخ الملفات بالتوازي مع الأجهزة الظاهرية الهدف.

CleanTargetBeforeCopy - هدف نظيف
boolean. ‏‏اختياري. استخدم عندما Destination = AzureVMs. القيمة الافتراضية: false.

يقوم الإعداد بتنظيف true المجلد الوجهة قبل تنفيذ إجراء النسخ.

skipCACheck - اختبار الشهادة
boolean. ‏‏اختياري. استخدم عندما Destination = AzureVMs. القيمة الافتراضية: true.

لن تتحقق القيمة الافتراضية مما إذا تم توقيع شهادة الخادم من قبل مرجع مصدق موثوق به قبل الاتصال عبر HTTPS.

outputStorageUri - عنوان URI لحاوية التخزين
string.

حدد اسم المتغير المستخدم ل URI لحاوية التخزين الذي تم نسخ الملفات إليه. صالح فقط عندما تكون الوجهة المحددة هي Azure Blob.

outputStorageContainerSasToken - رمز SAS المميز لحاوية التخزين
string.

حدد اسم المتغير المستخدم للرمز المميز SAS لحاوية التخزين الذي يصل إلى الملفات التي تم نسخها. صالح فقط عندما تكون الوجهة المحددة هي Azure Blob.

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

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

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

لا شيء

المتطلبات

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