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 = FilePathkullanı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 = InlineScriptkullanı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 = FilePathkullanı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 = OtherVersiongereklidir.

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.exekullanırpwsh.exe.


validateScriptSignature - Betik imzasını doğrulama
boolean. İsteğe bağlı. when ScriptType = FilePathkullanı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