다음을 통해 공유


AzureCLI@1 - Azure CLI v1 작업

Windows 에이전트에서 실행할 때 Linux 에이전트 또는 일괄 처리 스크립트에서 실행할 때 셸 스크립트에서 Azure 구독에 대해 Azure CLI 명령을 실행합니다.

Azure 구독에 대해 Azure CLI 명령을 사용하여 셸 또는 일괄 처리 스크립트를 실행합니다.

Syntax

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure CLI v1
# Run a Shell or Batch script with Azure CLI commands against an azure subscription.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

입력

azureSubscription - Azure 구독
입력 별칭: connectedServiceNameARM. string. 필수 요소.

배포에 대한 Azure Resource Manager 구독을 선택합니다.


scriptLocation - 스크립트 위치
string. 필수 요소. 허용되는 값: inlineScript (인라인 스크립트), scriptPath (스크립트 경로). 기본값은 scriptPath입니다.

스크립트 위치를 선택합니다.


scriptPath - 스크립트 경로
string. 필요한 경우 scriptLocation = scriptPath입니다.

스크립트의 정규화된 경로 또는 기본 작업 디렉터리를 기준으로 하는 경로입니다.


inlineScript - 인라인 스크립트
string. 필요한 경우 scriptLocation = inlineScript입니다.

여기에서 스크립트를 인라인으로 작성할 수 있습니다. Windows 에이전트를 사용하는 경우 일괄 처리 스크립팅을 사용합니다. Linux 기반 에이전트를 사용할 때 셸 스크립팅을 사용합니다. 일괄 처리 파일의 경우 모든 Azure 명령 앞에 접두사를 call 사용합니다. 인수를 사용하여 미리 정의된 및 사용자 지정 변수를 이 스크립트에 전달할 수도 있습니다.

다음 예를 참조하십시오. 첫 번째는 셸 예제이고 두 번째는 일괄 처리 예제입니다.

azure --version || azure account show 
call  azure --version || call azure account show

arguments - 인수
입력 별칭: args. string.

스크립트에 전달된 인수입니다.


addSpnToEnvironment - 스크립트에서 서비스 주체 세부 정보에 액세스
boolean. 기본값은 false입니다.

스크립트의 실행 환경에 선택한 Azure 엔드포인트의 서비스 주체 ID 및 키를 추가합니다. 스크립트에서 $servicePrincipalId$servicePrincipalKey 변수를 사용할 수 있습니다.

이것은 Azure 엔드포인트에 서비스 주체 인증 체계가 있는 경우에만 적용됩니다.


useGlobalConfig - 전역 Azure CLI 구성 사용
boolean. 기본값은 false입니다.

false이면 이 작업은 별도의 Azure CLI 구성 디렉터리를 사용합니다. 병렬 릴리스에서 Azure CLI 작업을 실행하는 데 사용할 수 있습니다.


workingDirectory - 작업 디렉터리
입력 별칭: cwd. string.

스크립트가 실행되는 현재 작업 디렉터리입니다. 비워 두면 이 입력은 리포지토리(빌드) 또는 아티팩트(릴리스)의 루트()입니다 $(System.DefaultWorkingDirectory).


failOnStandardError - 표준 오류 발생 시 실패
boolean. 기본값은 false입니다.

이 입력이 true이면 오류가 StandardError 스트림에 기록될 때 이 작업이 실패합니다. 표준 오류를 무시하고 대신 종료 코드를 사용하여 상태 확인란의 선택을 취소합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

버전 1.0의 새로운 기능:

  • Python 기반의 새 Azure CLI 2.0을 지원합니다.
  • 플랫폼 간 에이전트(Linux, macOS 또는 Windows)에서 작동
  • Azure CLI 1.0(node.js 기반)으로 작업하려면 작업 버전 0.0으로 전환합니다.
  • 제한 사항: - Azure 클래식 구독에 대한 지원이 없습니다. Azure CLI 2.0은 ARM(Azure Resource Manager) 구독만 지원합니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 2.0.0 이상
작업 범주 배포