PowerShellOnTargetMachines@1 - PowerShell pada tugas Target Machines v1

Artikel
06/11/2024

Gunakan tugas ini untuk menjalankan skrip PowerShell pada komputer jarak jauh.

Sintaks

# PowerShell on Target Machines v1
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    ScriptPath: # string. Required. PowerShell Script. 
    #ScriptArguments: # string. Script Arguments. 
    #InitializationScriptPath: # string. Initialization Script. 
    #SessionVariables: # string. Session Variables. 
  # Advanced Options
    #RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

Input

EnvironmentName - Mesin
string. Wajib diisi.

Menentukan daftar alamat IP komputer atau FQDN yang dipisahkan koma, bersama dengan port. Porta default didasarkan pada protokol yang dipilih.
Misalnya: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Anda juga dapat memberikan variabel output tugas lain, misalnya $(variableName). Jika Anda menggunakan HTTPS, nama atau IP komputer harus cocok dengan CN dalam sertifikat.

AdminUserName - Admin Masuk
string.

Menentukan login administrator untuk komputer target.

AdminPassword - Password
string.

Menentukan kata sandi administrator untuk komputer target. Variabel yang ditentukan dalam definisi build/rilis seperti $(passwordVariable) yang diterima. Anda dapat menandai jenis variabel sebagai secret untuk mengamankannya.

Protocol - Protokol
string. Nilai yang diizinkan: Http, Https.

Menentukan protokol yang akan digunakan untuk koneksi WinRM dengan komputer. Nilai defaultnya adalah HTTPS.

TestCertificate - Uji Sertifikat
boolean. Opsional. Gunakan saat Protocol = Https. Nilai default: true.

Melewati validasi keaslian sertifikat mesin oleh otoritas sertifikasi tepercaya. Parameter diperlukan untuk protokol HTTPS WinRM.

ScriptPath - Skrip PowerShell
string. Wajib diisi.

Menentukan lokasi skrip PowerShell pada komputer target atau pada jalur UNC, seperti C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - Argumen Skrip
string.

Menentukan argumen untuk skrip PowerShell. Bisa berupa parameter ordinal atau bernama, seperti -testParam pengujian.

InitializationScriptPath - Skrip Inisialisasi
string.

Menentukan lokasi skrip data untuk DSC pada komputer target atau pada jalur UNC, seperti C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Variabel Sesi
string.

Menentukan variabel sesi umum untuk kedua skrip. Misalnya, $variable = value atau $var1 = "value, 123".

RunPowershellInParallel - Menjalankan PowerShell secara Paralel
boolean. Nilai default: true.

Jika diatur ke true, menjalankan skrip PowerShell secara paralel pada komputer target.

ResourceFilteringMethod - Pilih Mesin Menurut
string. Nilai yang diizinkan: machineNames (Nama Mesin), tags. Nilai default: machineNames.

Opsional. Menentukan subset komputer dengan memberikan nama atau tag mesin.

MachineNames - Kriteria Filter
string.

Input ini hanya berlaku untuk grup mesin atau variabel output. Ini belum didukung untuk daftar datar komputer.

Menentukan daftar komputer, seperti dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 atau tag, seperti Role:DB; OS:Win8.1. Jika beberapa tag ditentukan, tugas akan berjalan di semua komputer dengan tag yang ditentukan. Default menjalankan tugas di semua komputer.

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	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	1.104.0 atau lebih tinggi
Kategori tugas	Sebarkan

Bagikan melalui