definição steps.pwsh
A pwsh
etapa 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.
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.
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.
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.
Definições que fazem referência a essa definição: etapas
Propriedades
pwsh
String. Obrigatório como primeira propriedade.
Script embutido do PowerShell.
errorActionPreference
String.
A menos que seja especificado de outra forma, a preferência de ação de erro usa como padrão a parada de valor. Consulte a seguinte seção para obter mais informações.
failOnStderr
String.
Falhará na tarefa se a saída for enviada para o Stderr?
ignoreLASTEXITCODE
String.
Verifique o código de saída final do script para determinar se a etapa foi bem-sucedida?
workingDirectory
String.
Inicie o script com este diretório de trabalho.
condition
String.
Avalie 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
String.
Nome legível para a tarefa.
target
destino.
Ambiente no qual executar essa tarefa.
enabled
booliano.
Executar essa tarefa quando o trabalho for executado?
env
dicionário de cadeia de caracteres.
Variáveis a serem mapeadas para o ambiente do processo.
name
String.
ID da etapa. Valores aceitáveis: [-_A-Za-z0-9]*.
timeoutInMinutes
String.
Tempo para 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 mais longo timeoutInMinutes
. Para obter mais informações, consulte Tempos limite.
retryCountOnTaskFailure
String.
Número de repetições se a tarefa falhar.
Comentários
A palavra-chave pwsh
é um atalho para a tarefa do PowerShell quando o valor pwsh dessa tarefa é definido como true.
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 enquanto o trabalho é executado. 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
Confira também
- Tarefa do PowerShell
- Saiba mais sobre condições e tempos limite