Azure PowerShell görevi

Makale
11/29/2021
Okumak için 2 dakika

Azure Pipelines

Bir Azure ortamında PowerShell betiği çalıştırmak için bu görevi kullanın. Azure bağlamı, sağlanan hizmet bağlantısıyla Azure Resource Manager doğrulanır.

YAML kod parçacığı

# Azure PowerShell
# Run a PowerShell script within an Azure environment
- task: AzurePowerShell@5
  inputs:
    #azureSubscription: Required. Name of Azure Resource Manager service connection
    #scriptType: 'FilePath' # Optional. Options: filePath, inlineScript
    #scriptPath: # Optional
    #inline: '# You can write your Azure PowerShell scripts inline here. # You can also pass predefined and custom variables to this script using arguments' # Optional
    #scriptArguments: # Optional
    #errorActionPreference: 'stop' # Optional. Options: stop, continue, silentlyContinue
    #failOnStandardError: false # Optional
    #azurePowerShellVersion: 'OtherVersion' # Required. Options: latestVersion, otherVersion
    #preferredAzurePowerShellVersion: # Required when azurePowerShellVersion == OtherVersion
    #pwsh: true # Optional. If true, then will use PowerShell Core pwsh.exe

Bağımsız değişkenler

Bağımsız Değişken	Description
`ConnectedServiceNameARM` Azure Aboneliği	(Gerekli) Kimlik doğrulaması için Azure Resource Manager hizmet bağlantısının adı. Bağımsız değişken diğer adı: `azureSubscription`
`ScriptType` Betik Türü	(İsteğe bağlı) Betiğin türü: filePath veya inlineScript Varsayılan değer: `FilePath`
`ScriptPath` Betik Yolu	(İsteğe bağlı) Betiğin yolu. Tam yol veya varsayılan çalışma diziniyle göreli olmalıdır.
`Inline` Satır Içi Betik	(İsteğe bağlı) Yürütülecek betiği girin. Varsayılan değer: # Betiklerinizi satır Azure PowerShell burada yazabilirsiniz.
`ScriptArguments` Betik Bağımsız Değişkenleri	(İsteğe bağlı) PowerShell'e geçiş için ek parametreler. Genel veya adlandırılmış parametreler olabilir. Satır içi betik seçeneği için geçerli değildir.
`errorActionPreference` ErrorActionPreference	(İsteğe bağlı) Betiği yürütmek için ErrorActionPreference değişkeninin değerini seçin. Varsayılan değer: `stop`
`FailOnStandardError` Standart Hatada Başarısız Oldu	(İsteğe bağlı) Bu doğruysa, 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. Varsayılan değer: `false`
`TargetAzurePs` Azure PowerShell Sürümü	(Gerekli) Microsoft tarafından barındırılan aracılar için desteklenen Azure PowerShell. Aracıda kullanılabilir en son sürümü seçmek için `Latest installed version.` Kendinden konak aracılar için, "Sürümü belirt" Azure PowerShell tercih edilen sürümünü belirterek Varsayılan değer: `OtherVersion` Bağımsız değişken diğer adı: `azurePowerShellVersion`
`CustomTargetAzurePs` preferredAzurePowerShellVersion	(TargetAzurePs = OtherVersion olduğunda gereklidir) Tercih Azure PowerShell Sürümü düzgün bir semantik sürüm olması gerekir. Örneğin, 1.2.3. 2.,2.3. gibi regex desteklenmiyor. Bağımsız değişken diğer adı: `preferredAzurePowerShellVersion`
`pwsh` Use PowerShell Core	(İsteğe bağlı) Bu doğruysa, Windows, görev pwsh.exe yerine PATH'inizi powershell.exe.
`workingDirectory` Çalışma Dizini	(İsteğe bağlı) Betiğin çalıştığı çalışma dizini.

Örnekler

- 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

Sorun giderme

Betik yerel olarak çalıştı ama 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 izinleri olmaması durumunda oluşur. Betik yerel olarak kimlik bilgilerinizle çalışır ve gerekli erişime sahip olacağınız için başarılı olur.

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

Hata: Şu modüller bulunemedi: ' < modül adı > ' Sürüm: ' sürümü ' <> . Modül kısa süre önce yüklendiyse, görev aracınızı yeniden başlattıktan sonra Azure Pipelines deneyin

Azure PowerShell, Azure Aboneliği ile etkileşim kurmak için Azure/AzureRM/Az PowerShell Modülü kullanır. Bu sorun, PowerShell modülü Barındırılan Aracıda kullanılabilir durumda değilken oluşur. Bu nedenle, belirli bir görev sürümü Azure PowerShell sürümü, kullanılabilir sürümler listesinden Azure PowerShell sürüm seçeneklerinde belirtilmelidir. Yüklü yazılım, Microsoft tarafından barındırılan aracıların Yazı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.

Açık kaynak

Bu görev, üzerinde açık kaynak GitHub. Geri bildirim ve katkılar açıktır.