BatchScript@1 - Tugas skrip batch v1

  • Artikel

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

Sintaks

# 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.

# Batch Script v1
# Run a windows cmd or bat 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.

Input

filename - Jalan
string. Wajib diisi.

Jalur atau .bat skrip yang .cmd akan dijalankan. 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.)


arguments - Argumen
string.

Argumen yang diteruskan ke .cmd atau .bat skrip.


modifyEnvironment - Ubah Lingkungan
boolean. Nilai default: False.

Menentukan apakah modifikasi variabel lingkungan akan memengaruhi tugas berikutnya.


workingFolder - Folder kerja
string.

Direktori kerja saat ini ketika 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 StandardError aliran.


Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

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

Catatan

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 pembuatan 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
Permintaan Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: Cmd
Kemampuan Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah Apa pun
Variabel yang dapat diatur Apa pun
Versi agen 1.83.0 atau lebih tinggi
Kategori tugas Utilitas