مشاركة عبر

تعريف steps.pwsh

  • مقالة

تقوم pwsh الخطوة بتشغيل برنامج نصي في PowerShell Core على Windows وmacOS وLinux.

steps:
- pwsh: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

steps:
- pwsh: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

steps:
- pwsh: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

التعريفات التي تشير إلى هذا التعريف: الخطوات

الخصائص

pwsh سلسله. مطلوب كخاصية أولى.
برنامج PowerShell النصي المضمن.

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

failOnStderr سلسله.
هل تفشل المهمة إذا تم إرسال الإخراج إلى Stderr؟

ignoreLASTEXITCODE سلسله.
تحقق من رمز الخروج النهائي للبرنامج النصي لتحديد ما إذا كانت الخطوة قد نجحت؟

workingDirectory سلسله.
ابدأ تشغيل البرنامج النصي باستخدام دليل العمل هذا.

condition سلسله.
قم بتقييم تعبير الشرط هذا لتحديد ما إذا كنت تريد تشغيل هذه المهمة.

continueOnErrorمنطقي.
هل تستمر في التشغيل حتى عند الفشل؟

displayName سلسله.
اسم يمكن للبشر قراءته للمهمة.

targetالهدف.
البيئة التي سيتم فيها تشغيل هذه المهمة.

enabledمنطقي.
هل تقوم بتشغيل هذه المهمة عند تشغيل المهمة؟

env قاموس السلسلة.
المتغيرات المراد تعيينها في بيئة العملية.

name سلسله.
معرف الخطوة. القيم المقبولة: [-_A-Za-z0-9]*.

timeoutInMinutes سلسله.
حان الوقت للانتظار حتى تكتمل هذه المهمة قبل أن يقتلها الخادم.

ملاحظة

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

retryCountOnTaskFailure سلسله.
عدد عمليات إعادة المحاولة إذا فشلت المهمة.

الملاحظات

pwsh الكلمة الأساسية هي اختصار لمهمة PowerShell عند تعيين قيمة pwsh لتلك المهمة إلى true. تقوم المهمة بتشغيل برنامج نصي في PowerShell Core على Windows وmacOS وLinux.

تعرف على المزيد حول الشروطوالمهلات.

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

أمثلة

steps:
- pwsh: Write-Host Hello $($env:name)
  displayName: Say hello
  name: firstStep
  workingDirectory: $(build.sourcesDirectory)
  failOnStderr: true
  env:
    name: Microsoft

راجع أيضًا