BatchScript@1 - Toplu iş betiği v1 görevi

Makale
07/02/2024

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

Syntax

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

Girişler

filename - Yolu
string. Gereklidir.

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 belirtilebilen ile workingFolderfarklı olabileceğini lütfen unutmayın.)

arguments - Bağımsız değişken
string.

veya .bat betiğine .cmd geçirilen bağımsız değişkenler.

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.

Betik çalıştırıldığında geçerli çalışma dizini. Bu varsayılan olarak betiğin bulunduğu klasöre ayarlanır.

failOnStandardError - Standart Hatada Başarısız Oldu
boolean. Varsayılan değer: false.

Bu doğruysa, akışa StandardError herhangi bir hata yazıldığında bu görev başarısız olur.

Görev denetimi 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 betiği ç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.

Not

Bu görev Windows kapsayıcılarıyla uyumlu değil. Windows kapsayıcısı üzerinde bir toplu iş betiği çalıştırmanız gerekiyorsa, bunun yerine komut satırı görevini kullanın.

Birden çok platformu destekleme hakkında bilgi için bkz. Platformlar arası betik oluşturma.

Örnekler

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

@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çi barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: Cmd
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	1.83.0 veya üzeri
Görev kategorisi	Yardımcı Program

Aracılığıyla paylaş