Compartilhar via

definição steps.pwsh

A etapa pwsh executa um script no PowerShell Core no Windows, macOS e Linux.

steps:
- pwsh: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

Definições que fazem referência a essa definição: etapas

Propriedades

pwsh cadeia de caracteres. Obrigatório como primeira propriedade.
script embutido do PowerShell.

errorActionPreference cadeia de caracteres.
, a menos que especificado de outra forma, a preferência de ação de erro usa como padrão a parada de valor. Consulte a seção a seguir para obter mais informações.

failOnStderr cadeia de caracteres.
Falhar na tarefa se a saída for enviada ao Stderr?

ignoreLASTEXITCODE cadeia de caracteres.
Verificar o código de saída final do script para determinar se a etapa foi bem-sucedida?

workingDirectory cadeia de caracteres.
iniciar o script com esse diretório de trabalho.

condition cadeia de caracteres.
Avaliar essa expressão de condição para determinar se essa tarefa deve ser executada.

continueOnError booliano.
Continuar em execução mesmo em caso de falha?

displayName cadeia de caracteres.
nome legível para a tarefa.

target de destino.
Ambiente no qual executar essa tarefa.

enabled booliano.
executar essa tarefa quando o trabalho for executado?

env dicionário de cadeias de caracteres.
variáveis a serem mapeadas para o ambiente do processo.

name cadeia de caracteres.
ID da etapa. Valores aceitáveis: [-_A-Za-z0-9]*.

timeoutInMinutes cadeia de caracteres.
hora de aguardar a conclusão dessa tarefa antes que o servidor a mate.

Observação

Os pipelines podem ser configurados com um tempo limite de nível de trabalho. Se o intervalo de tempo limite do nível do trabalho se esgotar antes da conclusão da etapa, o trabalho em execução (incluindo a etapa) será encerrado, mesmo que a etapa esteja configurada com um intervalo de timeoutInMinutes mais longo. Para obter mais informações, consulte Timeouts.

retryCountOnTaskFailure cadeia de caracteres.
Número de repetições se a tarefa falhar.

Observações

A palavra-chave pwsh é um atalho para a tarefa do PowerShell quando o valor pwsh dessa tarefa é definido como verdadeiro. A tarefa executa um script no PowerShell Core no Windows, macOS e Linux.

Saiba mais sobre condições e tempos limite.

Cada sessão do PowerShell dura apenas a duração do trabalho no qual ela é executada. As tarefas que dependem do que foi inicializado devem estar no mesmo trabalho que a inicialização.

Exemplos

steps:
- pwsh: Write-Host Hello $($env:name)
  displayName: Say hello
  name: firstStep
  workingDirectory: $(build.sourcesDirectory)
  failOnStderr: true
  env:
    name: Microsoft

Consulte também

  • Last updated on