AzurePowerShell@4 - Azure PowerShell v4 görevi
Bir Azure ortamında PowerShell betiğini çalıştırmak için bu görevi kullanın. Azure bağlamı, sağlanan Azure Resource Manager hizmeti bağlantısıyla doğrulanır.
Syntax
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription.
#ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
#RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. Default: false.
# Azure PowerShell version options
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
# Advanced
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription.
#ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
#RestrictContextToCurrentTask: false # boolean. Restrict scope of context to current task. Default: false.
# Azure PowerShell version options
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
# Advanced
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription.
#ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure PowerShell version options
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
# Advanced
#pwsh: false # boolean. Use PowerShell Core. Default: false.
#workingDirectory: # string. Working Directory.
# Azure PowerShell v4
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@4
inputs:
azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription.
#ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Script Type. Default: FilePath.
#ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path.
#Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script.
#ScriptArguments: # string. Optional. Use when ScriptType = FilePath. Script Arguments.
#errorActionPreference: 'stop' # 'stop' | 'continue' | 'silentlyContinue'. ErrorActionPreference. Default: stop.
#FailOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure PowerShell version options
#azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.
Girişler
azureSubscription
- Azure Aboneliği
Giriş diğer adı: ConnectedServiceNameARM
. string
. Gereklidir.
PowerShell'i çalıştırmadan önce yapılandırılan Azure Resource Manager aboneliği.
ScriptType
- Betik Türü
string
. İzin verilen değerler: FilePath
(Betik Dosyası Yolu), InlineScript
(Satır içi Betik). Varsayılan değer: FilePath
.
Betiğin türü: dosya yolu veya satır içi.
ScriptPath
- Betik Yolu
string
. İsteğe bağlı. when ScriptType = FilePath
kullanın.
Betiğin yolu. Bu, tam yol veya varsayılan çalışma dizinine göre bir yol olmalıdır.
Inline
- Satır içi Betik
string
. İsteğe bağlı. when ScriptType = InlineScript
kullanın. Varsayılan değer: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments
.
Betiği yürütülecek şekilde belirtir. Desteklenen satır içi betik uzunluğu üst sınırı 5000 karakterdir. Daha uzun bir betik kullanmak istiyorsanız bir dosyadan betik kullanın.
ScriptArguments
- Betik Bağımsız Değişkenleri
string
. İsteğe bağlı. when ScriptType = FilePath
kullanın.
PowerShell'e geçirmek için ek parametreler. Sıralı veya adlandırılmış parametreler olabilir.
errorActionPreference
- ErrorActionPreference
string
. İzin verilen değerler: stop
, continue
, silentlyContinue
. Varsayılan değer: stop
.
Betiği yürütmek için değişkenin ErrorActionPreference
değerini seçer.
FailOnStandardError
- Standart Hatada Başarısız Oldu
boolean
. Varsayılan değer: false
.
Bu doğru olduğunda, hata işlem hattına herhangi bir hata yazılırsa veya standart hata akışına herhangi bir veri yazılırsa bu görev başarısız olur.
RestrictContextToCurrentTask
- Bağlam kapsamını geçerli görevle kısıtla
boolean
. Varsayılan değer: false
.
Bu doğru olduğunda, bu görev bağlam kapsamını yalnızca geçerli görevle kısıtlar ve özel bir aracı kullanılırken bağlam işlem hattındaki diğer görevler için kullanılamaz.
azurePowerShellVersion
- Azure PowerShell Sürümü
Giriş diğer adı: TargetAzurePs
. string
. İzin verilen değerler: LatestVersion
(En son yüklü sürüm), OtherVersion
(Diğer sürümü belirtin). Varsayılan değer: OtherVersion
.
Barındırılan aracılar söz konusu olduğunda desteklenen Azure PowerShell Sürümü: 1.0.0
(Barındırılan VS2017 Kuyruğu).
Aracıda kullanılabilen en son sürümü seçmek için (En son yüklü sürüm) seçeneğini belirleyin LatestVersion
.
Özel aracılar için kullanarak tercih edilen Azure PowerShell OtherVersion
sürümünü belirtebilirsiniz (Diğer sürümü belirtin).
preferredAzurePowerShellVersion
- Tercih Edilen Azure PowerShell Sürümü
Giriş diğer adı: CustomTargetAzurePs
. string
. olduğunda TargetAzurePs = OtherVersion
gereklidir.
Tercih edilen Azure PowerShell Sürümünün düzgün bir anlamsal sürüm olması gerekir; örneğin. 1.2.3.
gibi 2.\*,2.3.\*
regex desteklenmez. Barındırılan VS2017 Havuzu şu anda Az modülü sürümünü destekliyor 1.0.0.
pwsh
- PowerShell Core kullanma
boolean
. Varsayılan değer: false
.
Bu doğruysa, Windows'ta görev yerine yolunuzdan powershell.exe
kullanırpwsh.exe
.
validateScriptSignature
- Betik imzasını doğrulama
boolean
. İsteğe bağlı. when ScriptType = FilePath
kullanın. Varsayılan değer: false
.
Bu doğruysa, görev yürütmeden önce belirtilen betiğin imzalandığından ve geçerli olduğundan emin olmak için denetler.
workingDirectory
- Çalışma Dizini
string
.
Betiğin çalıştırıldığı çalışma dizini.
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
Az Module ve platformlar arası aracılar için destek eklendi.
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.115.0 veya üzeri |
Görev kategorisi | Dağıtma |