steps.powershell tanımı

Bu adım, powershell Windows PowerShell (Windows üzerinde) veya pwsh (Linux ve macOS) kullanarak bir betik çalıştırır.

steps:
- powershell: 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.

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

Özellikler

powershell 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 durağı olur. 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 olur mu?

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.

boolecontinueOnError.
Hata durumunda bile çalışmaya devam ?

displayName dize.
Görev için İnsan tarafından okunabilir bir ad .

hedeftarget.
bu görevin çalıştırıldığı ortamı .

booleenabled.
İş çalıştırıldığında bu görevi çalıştır ?

dize sözlüğü env.
İşlemin ortamına eşlemek için Değişkenleri .

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

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

Uyarı

İş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 bir timeoutInMinutes aralığıyla yapılandırılmış olsa bile çalışan iş (adımınız dahil) sonlandırılır. Daha fazla bilgi için Zaman Aşımları'na bakın.

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

Açıklamalar

powershell Anahtar sözcük, PowerShell görevi için bir kısayoldur. Görev, Windows PowerShell (Windows üzerinde) veya pwsh (Linux ve macOS) kullanarak bir betik çalıştırır.

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.

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

Hata eylemi tercihi

Aksi belirtilmedikçe, hata eylemi tercihi varsayılan olarak değerine stopayarlanır ve satır $ErrorActionPreference = 'stop' betiğinizin en üstüne eklenir.

Hata eylemi tercihi durdurulacak şekilde ayarlandığında, hatalar PowerShell'in görevi sonlandırmasına ve sıfır olmayan bir çıkış kodu döndürmesine neden olur. Görev ayrıca Başarısız olarak işaretlenir.

errorActionPreference: stop | continue | silentlyContinue

steps:
- powershell: |
    Write-Error 'Uh oh, an error occurred'
    Write-Host 'Trying again...'
  displayName: Error action preference
  errorActionPreference: continue

Son çıkış kodunu yoksay

Betiğinizden döndürülen son çıkış kodu varsayılan olarak denetlenür. Sıfır olmayan kod bir adım hatasını gösterir; bu durumda sistem betiğinizi şununla ekler:

if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }

Bu davranışı istemiyorsanız belirtin ignoreLASTEXITCODE: true.

ignoreLASTEXITCODE: boolean

steps:
- powershell: git nosuchcommand
  displayName: Ignore last exit code
  ignoreLASTEXITCODE: true

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

Örnekler

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

Ayrıca bakınız

  • Last updated on