AzurePowerShell@4 - tugas Azure PowerShell v4

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

Sintaks

# 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.

Input

azureSubscription - Langganan Azure
Alias input: ConnectedServiceNameARM. string. Wajib diisi.

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

Parameter tambahan untuk diteruskan ke PowerShell. Dapat 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.

RestrictContextToCurrentTask - Membatasi cakupan konteks ke tugas saat ini
boolean. Nilai default: false.

Jika ini benar, tugas ini akan membatasi cakupan konteks hanya untuk tugas saat ini, dan konteksnya tidak akan tersedia untuk tugas lain dalam alur saat menggunakan agen privat.

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: 1.0.0 (Antrean VS2017 yang Dihosting). 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. Kumpulan VS2017 yang Dihosting saat ini mendukung versi modul Az 1.0.0.

pwsh - Menggunakan PowerShell Core
boolean. Nilai default: false.

Jika ini benar, maka pada Windows tugas akan menggunakan pwsh.exe dari jalur Anda alih-alih powershell.exe.

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

Jika ini benar, maka tugas akan terlebih dahulu memeriksa untuk memastikan skrip yang ditentukan ditandatangani dan valid sebelum mengeksekusinya.

workingDirectory - Direktori Kerja
string.

Direktori kerja tempat skrip dijalankan.

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 Modul Az dan agen lintas platform.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.115.0 atau lebih tinggi
Kategori tugas	Sebarkan