AzureCLI@1 - Azure CLI v1 görevi

Windows aracısı üzerinde çalışırken Linux aracısı veya toplu iş betiği üzerinde çalışırken bir kabuk betiğinde Azure aboneliğinde Azure CLI komutlarını çalıştırın.

Azure aboneliğinde Azure CLI komutlarıyla bir kabuk veya toplu iş betiği çalıştırın.

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.

Girişler

azureSubscription - Azure aboneliği
Giriş diğer adı: connectedServiceNameARM. string. Gereklidir.

Dağıtım için bir Azure Resource Manager aboneliği seçer.


scriptLocation - Betik Konumu
string. Gereklidir. İzin verilen değerler: inlineScript (Satır içi betik), scriptPath (Betik yolu). Varsayılan değer: scriptPath.

Betik konumunu seçer.


scriptPath - Betik Yolu
string. olduğunda scriptLocation = scriptPathgereklidir.

Betiğin tam yolu veya varsayılan çalışma dizinine göre bir yol.


inlineScript - Satır içi Betik
string. olduğunda scriptLocation = inlineScriptgereklidir.

Betiklerinizi satır içinde buraya yazabilirsiniz. Windows aracısını kullanırken toplu komut dosyası kullanın. Linux tabanlı aracıları kullanırken kabuk betiği kullanma. Toplu iş dosyaları için her Azure komutundan önce ön eki call kullanın. Bağımsız değişkenleri kullanarak bu betikte önceden tanımlanmış ve özel değişkenler de geçirebilirsiniz

Aşağıdaki örneklere bakın. Birincisi bir kabuk örneği, ikincisi ise toplu iş örneğidir:

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

arguments - Bağımsız değişken
Giriş diğer adı: args. string.

Betike geçirilen bağımsız değişkenler.


addSpnToEnvironment - Betikteki hizmet sorumlusu ayrıntılarına erişme
boolean. Varsayılan değer: false.

Seçtiğiniz Azure uç noktasının hizmet sorumlusu kimliğini ve anahtarını betiğin yürütme ortamına ekler. betiğinizde ve $servicePrincipalKey değişkenlerini kullanabilirsiniz$servicePrincipalId.

Bu, yalnızca Azure uç noktasının Hizmet Sorumlusu kimlik doğrulama düzeni olduğunda kabul edilir.


useGlobalConfig - Genel Azure CLI yapılandırmasını kullanma
boolean. Varsayılan değer: false.

Bu yanlışsa, bu görev kendi ayrı Azure CLI yapılandırma dizinini kullanır. Bu, Azure CLI görevlerini paralel sürümlerde çalıştırmak için kullanılabilir.


workingDirectory - Çalışma Dizini
Giriş diğer adı: cwd. string.

Betiğin çalıştırıldığı geçerli çalışma dizini. Boş bırakılırsa, bu giriş deponun (derleme) veya yapıtların (yayın) köküdür $(System.DefaultWorkingDirectory).


failOnStandardError - Standart Hatada Başarısız Oldu
boolean. Varsayılan değer: false.

Bu giriş doğruysa, Herhangi bir hata StandardError akışına yazıldığında bu görev başarısız olur. Standart hataları yoksaymak için onay kutusunu temizleyin ve bunun yerine durumu belirlemek için çıkış kodlarını kullanın.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Sürüm 1.0'daki yenilikler:

  • Python tabanlı yeni Azure CLI 2.0'i destekler
  • Platformlar arası aracılarla (Linux, macOS veya Windows) çalışır
  • Azure CLI 1.0 (node.js tabanlı) ile çalışmak için görev sürümü 0.0'a geçin
  • Sınırlamalar: - Klasik Azure abonelikleri için destek yoktur. Azure CLI 2.0 yalnızca Azure Resource Manager (ARM) aboneliklerini destekler.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.0.0 veya üzeri
Görev kategorisi Dağıtma