BatchScript@1 - Toplu komut dosyası v1 görevi

Bir Windows .bat veya .cmd komut dosyası çalıştırmak için bu görevi kullanın. İsteğe bağlı olarak, .bat veya .cmd komut dosyası ortam değişkenlerini kalıcı olarak değiştirebilir.

Sözdizimi

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

Girişler

filename - Yol
string. Gerekli.

Yürütülecek veya .bat betiğinin .cmd yolu. Bu, tam yol veya varsayılan çalışma dizinine göre bir yol olmalıdır. (Çalışma dizininin, bu görev için belirtilebilecek olan 'den workingFolderfarklı olabileceğini lütfen unutmayın.)

bağımsız değişkenleri
string.

Bağımsız değişkenler veya .bat komut dosyasına geçirildi.cmd.

modifyEnvironment - Ortamı Değiştir
boolean. Varsayılan değer: False.

Ortam değişkeni değişikliklerinin sonraki görevleri etkileyip etkilemeyeceğini belirler.

workingFolder - Çalışma klasörü
string.

Bir komut dosyası çalıştırıldığında geçerli çalışma dizini. Bu, varsayılan olarak komut dosyasının bulunduğu klasörü kullanır.

standart hatabaşarısız failOnStandardError -
boolean. Varsayılan değer: false.

Bu doğruysa, StandardError akışına herhangi bir hata yazılırsa bu görev başarısız olur.

Görev denetim seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Bir Windows .bat veya .cmd komut dosyası çalıştırmak için bu görevi kullanın. İsteğe bağlı olarak, ortam değişkenlerini kalıcı olarak değiştirmesine izin verin.

Uyarı

Bu görev Windows kapsayıcıları ile uyumlu değildir. Bir Windows kapsayıcısında toplu komut dosyası çalıştırmanız gerekiyorsa, bunun yerine komut satırı görevini kullanın.

Birden çok platformu destekleme hakkında daha fazla bilgi için bkz: platformlar arası komut dosyası oluşturma.

Örnekler

Deponuzun kökünde test.bat oluşturun:

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

Bu betiği çalıştırmak için işlem hattınıza aşağıdaki görevi ekleyin.

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

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Şirket içinde barındırılan aracıların, bu görevi kullanan işleri çalıştırmak için taleplerine uyan özellikleri olmalıdır: Cmd
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenleri	Herhangi biri
Aracı sürümü	1.83.0 veya üzeri
Görev kategorisi	Fayda