مشاركة عبر

BatchScript@1 - مهمة البرنامج النصي الدفعي v1

  • مقالة

استخدم هذه المهمة لتشغيل Windows .bat أو .cmd برنامج نصي. اختياريا، يمكن للبرنامج .bat النصي أو .cmd تعديل متغيرات البيئة بشكل دائم.

بناء الجملة

# Batch script v1
# Run a Windows command or batch script and optionally allow it to change the environment.
- task: BatchScript@1
  inputs:
    filename: # string. Required. Path. 
    #arguments: # string. Arguments. 
    #modifyEnvironment: False # boolean. Modify Environment. Default: False.
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

# Batch Script v1
# Run a windows cmd or bat script and optionally allow it to change the environment.
- task: BatchScript@1
  inputs:
    filename: # string. Required. Path. 
    #arguments: # string. Arguments. 
    #modifyEnvironment: False # boolean. Modify Environment. Default: False.
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

الإدخالات

filename - مسار
string. مطلوب

مسار .cmd البرنامج النصي أو .bat لتنفيذه. يجب أن يكون هذا مسارا مؤهلا بالكامل أو مسارا بالنسبة إلى دليل العمل الافتراضي. (يرجى ملاحظة أن دليل العمل قد يختلف عن workingFolder، والذي يمكن تحديده لهذه المهمة.)


arguments - الحجج
string.

الوسيطات التي تم تمريرها .cmd إلى البرنامج النصي أو .bat .


modifyEnvironment - تعديل البيئة
boolean. القيمة الافتراضية: False.

تحديد ما إذا كانت تعديلات متغير البيئة ستؤثر على المهام اللاحقة.


workingFolder - مجلد العمل
string.

دليل العمل الحالي عند تشغيل برنامج نصي. يتم تعيين هذا افتراضيا إلى المجلد حيث يوجد البرنامج النصي.


failOnStandardError - فشل عند الخطأ القياسي
boolean. القيمة الافتراضية: false.

إذا كان هذا صحيحا، فستفشل هذه المهمة إذا تمت كتابة أي أخطاء في StandardError الدفق.


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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لتشغيل برنامج نصي Windows .bat أو .cmd. اختياريا، اسمح له بتعديل متغيرات البيئة بشكل دائم.

ملاحظة

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

للحصول على معلومات حول دعم أنظمة أساسية متعددة، راجع البرمجة النصية عبر الأنظمة الأساسية.

أمثلة

إنشاء test.bat في جذر المستودع الخاص بك:

@echo off
echo Hello World from %AGENT_NAME%.
echo My ID is %AGENT_ID%.
echo AGENT_WORKFOLDER contents:
@dir %AGENT_WORKFOLDER%
echo AGENT_BUILDDIRECTORY contents:
@dir %AGENT_BUILDDIRECTORY%
echo BUILD_SOURCESDIRECTORY contents:
@dir %BUILD_SOURCESDIRECTORY%
echo Over and out.

لتشغيل هذا البرنامج النصي، أضف المهمة التالية إلى البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.

- task: BatchScript@1
  inputs:
    filename: 'test.bat'

المتطلبات

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