definisi steps.powershell

Langkah powershell menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh (Linux dan macOS).

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.

Definisi yang mereferensikan definisi ini: langkah-langkah

Sifat

powershell tali. Diperlukan sebagai properti pertama.
skrip PowerShell sebaris.

errorActionPreference tali.
Kecuali ditentukan lain, preferensi tindakan kesalahan default ke nilai berhenti. Lihat bagian berikut untuk informasi selengkapnya.

failOnStderr tali.
Gagal tugas jika output dikirim ke Stderr?

ignoreLASTEXITCODE tali.
Periksa kode keluar akhir skrip untuk menentukan apakah langkah berhasil?

workingDirectory tali.
Mulai skrip dengan direktori kerja ini.

condition tali.
Evaluasi ekspresi kondisi ini untuk menentukan apakah akan menjalankan tugas ini.

continueOnError boolean.
Lanjutkan berjalan bahkan pada kegagalan?

displayName tali.
Nama yang dapat dibaca manusia untuk tugas tersebut.

target target.
Lingkungan tempat menjalankan tugas ini.

enabled boolean.
Jalankan tugas ini ketika pekerjaan berjalan?

env kamus string.
Variabel untuk dipetakan ke lingkungan proses.

name tali.
ID langkah. Nilai yang dapat diterima: [-_A-Za-z0-9]*.

timeoutInMinutes tali.
Waktu untuk menunggu tugas ini selesai sebelum server mematikannya.

Nota

Alur dapat dikonfigurasi dengan batas waktu tingkat pekerjaan. Jika interval batas waktu tingkat pekerjaan berlalu sebelum langkah Anda selesai, pekerjaan yang sedang berjalan (termasuk langkah Anda) dihentikan, bahkan jika langkah dikonfigurasi dengan interval timeoutInMinutes yang lebih lama. Untuk informasi selengkapnya, lihat Batas Waktu.

retryCountOnTaskFailure tali.
Jumlah percobaan ulang jika tugas gagal.

Komentar

Kata kunci powershell adalah pintasan untuk tugas PowerShell. Tugas menjalankan skrip menggunakan Windows PowerShell (di Windows) atau pwsh (Linux dan macOS).

Setiap sesi PowerShell hanya berlangsung selama durasi pekerjaan di mana ia berjalan. Tugas yang bergantung pada apa yang telah di-bootstrap harus berada dalam pekerjaan yang sama dengan bootstrap.

Pelajari selengkapnya tentang kondisi dan batas waktu .

Preferensi tindakan kesalahan

Kecuali ditentukan lain, preferensi tindakan kesalahan default ke nilai stop, dan baris $ErrorActionPreference = 'stop' ditambahkan ke bagian atas skrip Anda.

Saat preferensi tindakan kesalahan diatur untuk berhenti, kesalahan menyebabkan PowerShell mengakhiri tugas dan mengembalikan kode keluar nonzero. Tugas ini juga ditandai sebagai Gagal.

errorActionPreference: stop | continue | silentlyContinue

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

Abaikan kode keluar terakhir

Kode keluar terakhir yang dikembalikan dari skrip Anda diperiksa secara default. Kode bukan nol menunjukkan kegagalan langkah, dalam hal ini sistem menambahkan skrip Anda dengan:

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

Jika Anda tidak menginginkan perilaku ini, tentukan ignoreLASTEXITCODE: true.

ignoreLASTEXITCODE: boolean

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

Pelajari selengkapnya tentang kondisi dan batas waktu .

Contoh

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

Lihat juga

• tugas PowerShell
• Pelajari selengkapnya tentang kondisi dan batas waktu