BatchScript@1 - Tarefa de script em lote v1

Use esta tarefa para executar um Windows .bat ou .cmd script. Opcionalmente, o .bat script or .cmd pode modificar permanentemente as variáveis de 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.

Entradas

filename - path
string. Obrigatório

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

argumentos arguments -
string.

Os argumentos passaram para o .cmd script or .bat .

modifyEnvironment - Modificar ambiente
boolean. Valor padrão: False.

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

de pasta de trabalho do workingFolder -
string.

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

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

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

Opções de controle de tarefa

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

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

Essa 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 como dar suporte a várias plataformas, consulte scripts de plataforma cruzada.

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 tarefa a seguir ao pipeline.

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

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
Demandas	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: Cmd
recursos	Essa tarefa não atende a nenhuma demanda 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