AzurePowerShell@3 - tugas Azure PowerShell v3

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

Sintaks

# Azure PowerShell v3
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@3
  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'. 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
    #validateScriptSignature: false # boolean. Optional. Use when ScriptType = FilePath. Validate script signature. Default: false.

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. 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 untuk dieksekusi. 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. Opsional. Gunakan saat ScriptType = FilePath.

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

errorActionPreference - ErrorActionPreference
string. Nilai yang diizinkan: stop, continue, dan silentlyContinue. Nilai default: stop.

Memilih nilai ErrorActionPreference variabel untuk mengeksekusi skrip.

FailOnStandardError - Gagal pada Kesalahan Standar
boolean. Nilai default: false.

Jika ini benar, tugas ini akan gagal jika ada kesalahan yang ditulis ke alur kesalahan atau jika ada data yang ditulis ke aliran kesalahan standar.

azurePowerShellVersion - Versi Azure PowerShell
Alias input: TargetAzurePs. string. Nilai yang diizinkan: LatestVersion (Versi terinstal terbaru), 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 pada 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 pilihan 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.1, 5.1.1 dan versi 2.1.0modul AzureRM , , 3.8.04.2.1, 5.1.1, 6.7.0.

validateScriptSignature - Memvalidasi tanda tangan skrip
boolean. Pilihan. Gunakan saat ScriptType = FilePath. Nilai default: false.

Jika ini benar, maka tugas pertama-tama akan memeriksa untuk memastikan skrip yang ditentukan ditandatangani dan valid sebelum menjalankannya.

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.

Keterangan

Menambahkan dukungan untuk Gagal pada kesalahan standar dan ErrorActionPreference.

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 apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.0.0 atau lebih tinggi
Kategori tugas	Sebarkan