BatchScript@1 - Tugas skrip batch v1

Gunakan tugas ini untuk menjalankan Windows .bat atau .cmd skrip. Secara opsional, .bat skrip atau .cmd dapat memodifikasi variabel lingkungan secara permanen.

Sintaksis

# Batch script v1
# Run a Windows command or batch script and optionally allow it to change the environment.
- task: BatchScript@1
  inputs:
    filename: # string. Required. Path. 
    #arguments: # string. Arguments. 
    #modifyEnvironment: False # boolean. Modify Environment. Default: False.
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Masukan

Jalur filename -
string. Dibutuhkan.

Jalur .cmd skrip atau yang .bat akan dieksekusi. Ini harus menjadi jalur yang sepenuhnya memenuhi syarat atau relatif terhadap direktori kerja default. (Harap dicatat bahwa direktori kerja dapat berbeda dari workingFolder, yang dapat ditentukan untuk tugas ini.)

Argumen
string.

Argumen diteruskan ke .cmd skrip atau .bat .

modifyEnvironment - Ubah Lingkungan
boolean. Nilai default: False.

Menentukan apakah modifikasi variabel lingkungan akan memengaruhi tugas berikutnya.

workingFolder - Folder kerja
string.

Direktori kerja saat ini saat skrip dijalankan. Ini default ke folder tempat skrip berada.

failOnStandardError - Gagal pada Kesalahan Standar
boolean. Nilai default: false.

Jika ini benar, tugas ini akan gagal jika ada kesalahan yang ditulis ke aliran StandardError.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel-variabel keluaran

Tidak ada.

Komentar

Gunakan tugas ini untuk menjalankan skrip Windows .bat atau .cmd. Secara opsional, izinkan untuk memodifikasi variabel lingkungan secara permanen.

Nota

Tugas ini tidak kompatibel dengan kontainer Windows. Jika Anda perlu menjalankan skrip batch pada kontainer Windows, gunakan tugas baris perintah sebagai gantinya.

Untuk informasi tentang mendukung beberapa platform, lihat skrip lintas platform.

Contoh

Buat test.bat di akar repositori Anda:

@echo off
echo Hello World from %AGENT_NAME%.
echo My ID is %AGENT_ID%.
echo AGENT_WORKFOLDER contents:
@dir %AGENT_WORKFOLDER%
echo AGENT_BUILDDIRECTORY contents:
@dir %AGENT_BUILDDIRECTORY%
echo BUILD_SOURCESDIRECTORY contents:
@dir %BUILD_SOURCESDIRECTORY%
echo Over and out.

Untuk menjalankan skrip ini, tambahkan tugas berikut ke alur Anda.

- task: BatchScript@1
  inputs:
    filename: 'test.bat'

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Tuntutan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan berikut menuntut untuk menjalankan pekerjaan yang menggunakan tugas ini: Cmd
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah	Apa saja
variabel yang Dapat Diatur	Apa saja
Versi agen	1.83.0 atau lebih tinggi
Kategori tugas	Utilitas