AzurePowerShell@2 - tugas Azure PowerShell v2

Artikel
06/11/2024

Gunakan tugas ini untuk menjalankan skrip PowerShell dalam lingkungan Azure. Konteks Azure diautentikasi dengan koneksi layanan Azure Resource Manager yang disediakan.

Sintaks

# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Required. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Script Arguments. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

Input

azureConnectionType - Jenis Koneksi Azure
Alias input: ConnectedServiceNameSelector. string. Nilai yang diizinkan: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Nilai default: ConnectedServiceNameARM.

azureClassicSubscription - Langganan Klasik Azure
Alias input: ConnectedServiceName. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceName.

Langganan Azure Classic untuk dikonfigurasi sebelum menjalankan PowerShell.

azureSubscription - Langganan Azure
Alias input: ConnectedServiceNameARM. string. Diperlukan saat ConnectedServiceNameSelector = ConnectedServiceNameARM.

Langganan Azure Resource Manager untuk dikonfigurasi sebelum menjalankan PowerShell.

ScriptType - Jenis Skrip
string. Wajib diisi. Nilai yang diizinkan: FilePath (Jalur File Skrip), InlineScript (Skrip Sebaris). Nilai default: FilePath.

Jenis skrip: jalur file atau sebaris.

ScriptPath - Jalur Skrip
string. Opsional. Gunakan saat ScriptType = FilePath.

Jalur skrip. Ini harus menjadi jalur yang sepenuhnya memenuhi syarat atau relatif terhadap direktori kerja default.

Inline - Skrip Sebaris
string. Pilihan. Gunakan saat ScriptType = InlineScript. Nilai default: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Menspesifikasikan skrip yang akan dijalankan. Panjang skrip sebaris maksimum yang didukung adalah 5000 karakter. Gunakan skrip dari file jika Anda ingin menggunakan skrip yang lebih panjang.

ScriptArguments - Argumen Skrip
string.

Parameter tambahan untuk diteruskan ke PowerShell. Ini bisa berupa parameter ordinal atau bernama.

azurePowerShellVersion - Versi Azure PowerShell
Alias input: TargetAzurePs. string. Nilai yang diizinkan: LatestVersion (Versi terbaru yang diinstal), OtherVersion (Tentukan versi lain). Nilai default: OtherVersion.

Dalam kasus agen yang dihosting, Versi Azure PowerShell yang didukung adalah 2.1.0, , 3.8.04.2.1, 5.1.1 dan 6.7.0. Untuk memilih versi terbaru yang tersedia di agen, pilih LatestVersion (Versi terbaru yang diinstal).

Untuk agen privat, Anda dapat menentukan versi Azure PowerShell pilihan menggunakan OtherVersion (Tentukan versi lain).

preferredAzurePowerShellVersion - Versi Azure PowerShell pilihan
Alias input: CustomTargetAzurePs. string. Diperlukan saat TargetAzurePs = OtherVersion.

Versi Azure PowerShell yang disukai harus menjadi versi semantik yang tepat misalnya. 1.2.3.. Regex seperti 2.\*,2.3.\* tidak didukung. Agen yang dihosting saat ini mendukung versi 2.1.0modul Azure , , 3.8.0, 4.2.15.1.1 dan versi 2.1.0modul AzureRM , , 3.8.0, 4.2.15.1.1, 6.7.0.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: azureps
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.95.0 atau lebih tinggi
Kategori tugas	Sebarkan

Bagikan melalui