steps.powershell 정의
powershell
단계에서는 Windows PowerShell(Windows) 또는 pwsh
(Linux 및 macOS)를 사용하여 스크립트를 실행합니다.
steps:
- powershell: 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:
- powershell: 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.
이 정의를 참조하는 정의: 단계
속성
powershell
문자열입니다. 첫 번째 속성으로 필요합니다.
인라인 PowerShell 스크립트를 .
errorActionPreference
문자열입니다.
달리 지정하지 않는 한 오류 작업 기본 설정은 기본적으로 값 중지로 설정됩니다. 자세한 내용은 다음 섹션을 참조하세요.
failOnStderr
문자열입니다.
출력이 Stderr로 전송되는 경우 작업을 실패하시겠습니까?
ignoreLASTEXITCODE
문자열입니다.
스크립트의 최종 종료 코드를 확인하여 단계가 성공했는지 확인하시겠습니까?
workingDirectory
문자열입니다.
이 작업 디렉터리로 스크립트를 시작합니다.
condition
문자열입니다.
이 조건 식을 평가하여 이 작업을 실행할지 여부를 결정합니다.
부울continueOnError
.
실패하더라도 계속 실행하시겠습니까?
displayName
문자열입니다.
작업에 대해 사람이 읽을 수 있는 이름을 .
대상target
.
이 작업을 실행할 환경입니다.
부울enabled
.
작업이 실행되면 이 작업을 실행하시겠습니까?
문자열 사전을 env
.
변수를 사용하여 프로세스의 환경에 매핑합니다.
name
문자열입니다.
단계의 ID입니다. 허용되는 값: [-_A-Za-z0-9]*.
timeoutInMinutes
문자열입니다.
서버가 종료되기 전에 이 작업이 완료되기를 기다리는 시간입니다.
비고
파이프라인은 작업 수준 시간 제한으로 구성할 수 있습니다. 단계가 완료되기 전에 작업 수준 제한 시간 간격이 경과하면 단계가 더 긴 timeoutInMinutes
간격으로 구성된 경우에도 실행 중인 작업(단계 포함)이 종료됩니다. 자세한 내용은 시간 제한을 참조 하세요.
retryCountOnTaskFailure
문자열입니다.
작업이 실패한 경우 재시도 횟수입니다.
비고
powershell
키워드는 PowerShell 작업대한 바로 가기입니다.
이 작업은 Windows PowerShell(Windows) 또는 pwsh
(Linux 및 macOS)를 사용하여 스크립트를 실행합니다.
각 PowerShell 세션은 실행되는 작업 기간 동안만 지속됩니다. 부트스트랩된 항목에 따라 달라지는 작업은 부트스트랩과 동일한 작업이어야 합니다.
오류 작업 기본 설정
달리 지정하지 않는 한 오류 작업 기본 설정은 기본적으로 stop
값으로 설정되며, 줄 $ErrorActionPreference = 'stop'
스크립트 맨 위에 추가됩니다.
오류 작업 기본 설정이 중지되도록 설정되면 오류로 인해 PowerShell이 작업을 종료하고 0이 아닌 종료 코드를 반환합니다. 태스크도 실패로 표시됩니다.
errorActionPreference: stop | continue | silentlyContinue
steps:
- powershell: |
Write-Error 'Uh oh, an error occurred'
Write-Host 'Trying again...'
displayName: Error action preference
errorActionPreference: continue
마지막 종료 코드 무시
스크립트에서 반환된 마지막 종료 코드는 기본적으로 확인됩니다. 0이 아닌 코드는 단계 오류를 나타내며, 이 경우 시스템에서 스크립트를 다음과 함께 추가합니다.
if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }
이 동작을 원하지 않는 경우 ignoreLASTEXITCODE: true
지정합니다.
ignoreLASTEXITCODE: boolean
steps:
- powershell: git nosuchcommand
displayName: Ignore last exit code
ignoreLASTEXITCODE: true
예시
steps:
- powershell: Write-Host Hello $Env:name
displayName: Say hello
name: firstStep
workingDirectory: $(build.sourcesDirectory)
failOnStderr: true
env:
name: Microsoft