steps.pwsh tanımı

  • Makale

Bu pwsh adım Windows, macOS ve Linux üzerinde PowerShell Core'da bir betik çalıştırır.

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.

Bu tanıma başvuran tanımlar: adımlar

Özellikler

pwsh Dize. İlk özellik olarak gereklidir.
Satır içi PowerShell betiği.

errorActionPreference Dize.
Aksi belirtilmediği sürece hata eylemi tercihi varsayılan olarak değer durdurma olarak ayarlanır. Daha fazla bilgi için aşağıdaki bölüme bakın.

failOnStderr Dize.
Çıktı Stderr'a gönderilirse görev başarısız mı olur?

ignoreLASTEXITCODE Dize.
Adımın başarılı olup olmadığını belirlemek için betiğin son çıkış kodu denetlensin mi?

workingDirectory Dize.
Betiği bu çalışma diziniyle başlatın.

condition Dize.
Bu görevin çalıştırılıp çalıştırılmayacağını belirlemek için bu koşul ifadesini değerlendirin.

continueOnErrorBoole değeri.
Hata durumunda bile çalışmaya devam mı edin?

displayName Dize.
Görevin insan tarafından okunabilen adı.

targethedef.
Bu görevin çalıştırıldığı ortam.

enabledBoole değeri.
İş çalıştırıldığında bu görev çalıştırılacak mı?

env dize sözlüğü.
İşlemin ortamına eşlenen değişkenler.

name Dize.
Adımın kimliği. Kabul edilebilir değerler: [-_A-Za-z0-9]*.

timeoutInMinutes Dize.
Sunucu sonlandırmadan önce bu görevin tamamlanmasını bekleme süresi.

Not

İşlem hatları iş düzeyi zaman aşımı ile yapılandırılabilir. İş düzeyi zaman aşımı aralığı adımınız tamamlanmadan önce geçerse, adım daha uzun timeoutInMinutes bir aralıkla yapılandırılmış olsa bile çalışan iş (adımınız dahil) sonlandırılır. Daha fazla bilgi için bkz . Zaman Aşımları.

retryCountOnTaskFailure Dize.
Görev başarısız olursa yeniden deneme sayısı.

Açıklamalar

Anahtar pwsh sözcüğü, görevin pwsh değeri true olarak ayarlandığında PowerShell görevi için bir kısayoldur. Görev Windows, macOS ve Linux üzerinde PowerShell Core'da bir betik çalıştırır.

Koşullar ve zaman aşımları hakkında daha fazla bilgi edinin.

Her PowerShell oturumu yalnızca çalıştığı işin süresi boyunca sürer. Önyüklemenin ne olduğuna bağlı olan görevler, bootstrap ile aynı işte olmalıdır.

Örnekler

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

Ayrıca bkz.