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 = scriptPath
gereklidir.
Betiğin tam yolu veya varsayılan çalışma dizinine göre bir yol.
inlineScript
- Satır içi Betik
string
. olduğunda scriptLocation = inlineScript
gereklidir.
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 |