AzurePowerShell@5 - v5 görevini Azure PowerShell

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 hizmet bağlantısıyla doğrulanır.

Not

Varsayılan olarak Azure PowerShell v5, Linux aracıları için PowerShell Core ve Windows aracıları için Windows PowerShell kullanır. Windows aracılarında PowerShell'in en son sürümünü kullanmak için parametresini pwsh olarak trueayarlayın. Bunun yerine PowerShell Core kullanılacaktır.

Syntax

# Azure PowerShell v5
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@5
  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.
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.
    #workingDirectory: # string. Working Directory.

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ı. olduğunda 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ı. olduğunda 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.

Yürütülecek betiği gösterir. 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ı. olduğunda ScriptType = FilePathkullanın.

PowerShell'e geçirmek için ek parametreler. Bunlar sıralı veya adlandırılmış parametreler olabilir. Satır içi betik seçeneği için geçerli değildir.

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
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 veri yazılırsa bu görev başarısız olur.

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ümleri , 1.6.0, 2.3.2, 2.6.0ve 3.1.0 (Barındırılan VS2017 Sırası) şeklindedir1.0.0. Aracıda kullanılabilen en son sürümü seçmek için (En son yüklü sürüm) öğesini seçin LatestVersion .

Özel aracılar için kullanarak Azure PowerShell OtherVersion tercih edilen bir 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( örn. 1.2.3. gibi 2.\*,2.3.\* regex desteklenmez. Barındırılan VS2017 Havuzu şu anda Az modülü sürümlerini , , 2.3.21.6.0, 2.6.0ve 3.1.0sürümlerini 1.0.0destekler.

pwsh - PowerShell Core kullanma
boolean. Varsayılan değer: false.

Bu doğruysa, Windows aracılarında çalıştırılan görevler yerine yolunuz powershell.exeüzerinden kullanılırpwsh.exe.

validateScriptSignature - Betik imzasını doğrulama
boolean. İsteğe bağlı. olduğunda 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

Sorun giderme

Betik yerel olarak çalıştı, ancak işlem hattında başarısız oldu

Bu durum genellikle işlem hattında kullanılan hizmet bağlantısının betiği çalıştırmak için yeterli izinlere sahip olmaması durumunda oluşur. Betik yerel olarak kimlik bilgilerinizle çalışır ve gerekli erişime sahip olabileceğiniz için başarılı olur.

Bu sorunu çözmek için hizmet ilkesi/kimlik doğrulaması kimlik bilgilerinin gerekli izinlere sahip olduğundan emin olun. Daha fazla bilgi için bkz. Azure aboneliği kaynaklarınıza erişimi yönetmek için Role-Based Access Control kullanma.

Hata: Şu modüller bulunamadı: Sürüm: '<sürüm>' ile '<modül adı>'. Modül yakın zamanda yüklendiyse Azure Pipelines görev aracısını yeniden başlattıktan sonra yeniden deneyin

Azure PowerShell görev, Azure Aboneliği ile etkileşime geçmek için Azure/AzureRM/Az PowerShell Modülü kullanır. Bu sorun, PowerShell modülü Barındırılan Aracı'da kullanılamadığında oluşur. Bu nedenle, belirli bir görev sürümü için Tercih edilen Azure PowerShell sürümü, kullanılabilir sürümler listesindeki Azure PowerShell sürüm seçeneklerinde belirtilmelidir. Yüklü yazılım, Microsoft tarafından barındırılan aracılardakiYazılım tablosunda bulunabilir.

Hizmet Bağlantısı Sorunları

Hizmet bağlantılarıyla ilgili sorunları gidermek için bkz. Hizmet Bağlantısı sorunlarını giderme.

Örnekler

Aşağıdaki örnekte, bir dosyadan betik çağırma ve betik bağımsız değişkenlerini ona geçirme işlemleri gösterilmektedir.

- task: AzurePowerShell@5
  inputs:
    azureSubscription: my-arm-service-connection
    scriptType: filePath
    scriptPath: $(Build.SourcesDirectory)\myscript.ps1
    scriptArguments:
      -Arg1 val1 `
      -Arg2 val2 `
      -Arg3 val3
    azurePowerShellVersion: latestVersion
    pwsh: true

Aşağıdaki bağımsız değişkenler satır içi betiği çağırmayı gösterir.

- task: AzurePowerShell@5
  inputs:
    azureSubscription: 'Azure subscription connection placeholder'
    azurePowerShellVersion: LatestVersion
    ScriptType: 'InlineScript'
    Inline: |
      # You can write your azure powershell scripts inline here. 
      # You can also pass predefined and custom variables to this script using arguments
      Write-Host 'Hello'
      Write-Host 'World!'

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılı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