BatchScript@1 - Tarefa Batch script v1

Use esta tarefa para executar um Windows .bat ou .cmd script. Opcionalmente, o script ou .cmd pode modificar permanentemente variáveis de .bat ambiente.

Sintaxe

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

Insumos

filename - Caminho
string. Obrigatório

O caminho do .cmd script ou .bat a ser executado. Este deve ser um caminho totalmente qualificado ou relativo ao diretório de trabalho padrão. (Observe que o diretório de trabalho pode ser diferente do workingFolder, que pode ser especificado para esta tarefa.)

arguments - Argumentos
string.

Os argumentos passados para o .cmd script ou .bat .

modifyEnvironment - Modificar ambiente
boolean. Valor predefinido: False.

Determina se as modificações das variáveis de ambiente afetarão as tarefas subsequentes.

workingFolder - Pasta de trabalho
string.

O diretório de trabalho atual quando um script é executado. O padrão é a pasta onde o script está localizado.

failOnStandardError - falha no erro padrão
boolean. Valor predefinido: false.

Se isso for verdade, essa tarefa falhará se algum erro for gravado no fluxo de StandardError.

Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Use esta tarefa para executar um script do Windows .bat ou .cmd. Opcionalmente, permita que ele modifique permanentemente as variáveis de ambiente.

Observação

Esta tarefa não é compatível com contêineres do Windows. Se você precisar executar um script em lote em um contêiner do Windows, use a tarefa de linha de comando .

Para obter informações sobre o suporte a várias plataformas, consulte Scripts entre plataformas.

Exemplos

Crie test.bat na raiz do seu repositório:

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

Para executar esse script, adicione a seguinte tarefa ao seu pipeline.

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

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de executar trabalhos que usam essa tarefa: Cmd
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.83.0 ou superior
Categoria de tarefa	Utilidade