مشاركة عبر

PowerShell@1 - مهمة PowerShell v1

  • مقالة

تشغيل برنامج نصي PowerShell.

بناء الجملة

# PowerShell v1
# Run a PowerShell script.
- task: PowerShell@1
  inputs:
    scriptType: 'filePath' # 'inlineScript' | 'filePath'. Required. Type. Default: filePath.
    scriptName: # string. Required when scriptType = filePath. Script Path. 
    #arguments: # string. Arguments. 
    #inlineScript: # string. Required when scriptType = inlineScript. Inline Script. 
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: true # boolean. Fail on Standard Error. Default: true.

الإدخالات

scriptType - نوع
string. مطلوب القيم المسموح بها: inlineScript (البرنامج النصي المضمن)، filePath (مسار الملف). القيمة الافتراضية: filePath.

يحدد نوع البرنامج النصي للمهمة المراد تشغيلها: برنامج نصي مضمن أو مسار إلى .ps1 ملف.


scriptName - مسار البرنامج النصي
string. مطلوب عند scriptType = filePath.

يحدد نوع البرنامج النصي للمهمة المراد تشغيلها: برنامج نصي مضمن أو مسار إلى .ps1 ملف.


arguments - الحجج
string.

يحدد الوسيطات التي تم تمريرها إلى البرنامج النصي PowerShell. يمكن أن تكون الوسيطات معلمات ترتيبية أو معلمات مسماة. على سبيل المثال، ⁧-Name someName -Path -Value "Some long string value"⁩.

arguments لا يتم استخدامه عند targetType تعيين إلى inline.


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

يحدد دليل العمل حيث يتم تشغيل البرنامج النصي. إذا لم يتم تحديد قيمة، فإن دليل العمل هو $(Build.SourcesDirectory).


inlineScript - البرنامج النصي المضمن
string. مطلوب عند scriptType = inlineScript. القيمة الافتراضية: # You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host "Hello World".

يحدد محتويات البرنامج النصي. الحد الأقصى لطول البرنامج النصي المضمن المدعوم هو 500 حرف. استخدم برنامج نصي من ملف إذا كنت تريد استخدام برنامج نصي أطول.


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

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


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

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

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

لا شيء

الملاحظات

PowerShell@1 يعمل فقط على وكلاء Windows. لتشغيل PowerShell على أنواع عوامل أخرى، استخدم PowerShell@2.

تستمر كل جلسة PowerShell فقط طوال مدة المهمة التي يتم تشغيلها فيها. يجب أن تكون المهام التي تعتمد على ما تم تمهيده في نفس مهمة bootstrap.

تعيين متغير بحيث يمكن قراءته بواسطة البرامج النصية والمهام اللاحقة

لمعرفة المزيد حول تعريف متغيرات البناء في برنامج نصي، راجع تعريف متغيرات البناء وتعديلها في برنامج نصي.

لمعرفة المزيد حول تعريف متغيرات الإصدار في برنامج نصي، راجع تعريف متغيرات الإصدار وتعديلها في برنامج نصي.

تمرير أسرار البنية الأساسية لبرنامج ربط العمليات التجارية في البرنامج النصي، ولكن البيانات السرية غير مخفية في سجلات البنية الأساسية لبرنامج ربط العمليات التجارية

يجب أن تدرك أن PowerShell يقطع رسائل الخطأ، لذلك إذا كنت تستخدم أسرار البنية الأساسية لبرنامج ربط العمليات التجارية في برنامج نصي، يمكن اقتطاع الأسرار وعرضها. على سبيل المثال، في البرنامج النصي المضمن أدناه:

./script.ps1 --arg1 value1 --arg2 <some_secret_which_will_be_masked_here>

قد يكون هناك استثناء مثل: At <path_to_temp_script_file>:4 char:3

+   ./script.ps1 --arg1 value1 --arg2 <unmasked_part_of_original_secret> ...
+   ~~~~~~~~~~
    + <Additional exception details>

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

المتطلبات

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

راجع أيضًا