Partilhar via


BatchScript@1 - Tarefa de script v1 de lote

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

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.

Entradas

filename - Caminho
string. Obrigatório.

O caminho do .cmd ou .bat do guião para executar. Este deve ser um caminho totalmente qualificado ou um relativamente ao diretório de trabalho predefinido. (Por favor, note que o diretório de trabalho pode diferir de workingFolder, que poderia ser especificado para esta tarefa.)


arguments - Argumentos
string.

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


modifyEnvironment - Modificar o Ambiente
boolean. Valor predefinido: False.

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


workingFolder - Pasta de trabalho
string.

O diretório de trabalho atual quando um guião é executado. Isto desrescume da pasta onde o script está localizado.


failOnStandardError - Falha no Erro Padrão
boolean. Valor predefinido: false.

Se isso for verdade, esta tarefa falhará se forem escritos erros no StandardError stream.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para executar um script .bat do Windows ou .cmd. Opcionalmente, permita-lhe modificar permanentemente as variáveis ambientais.

Nota

Esta tarefa não é compatível com recipientes Windows. Se precisar de executar um script de lote num recipiente do Windows, utilize a tarefa da linha de comando .

Para obter informações sobre o suporte a várias plataformas, consulte o script da plataforma transversal.

Exemplos

Crie test.bat na raiz do seu repo:

@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 este script, adicione a seguinte tarefa ao seu pipeline.

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

Requisitos

Requisito Description
Tipos de gasodutos YAML, Construção clássica, lançamento clássico
Continua Agente, Grupo de Implementação
Exigências Os agentes auto-alojados devem ter capacidades que correspondam às seguintes exigências para executar empregos que utilizem esta tarefa: Cmd
Capacidades Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis de configuração Qualquer
Versão do agente 1.83.0 ou maior
Categoria da tarefa Utilitário