PowerShellOnTargetMachines@2 - 目的機器 v2 工作的 PowerShell
使用此工作在遠端電腦上執行 PowerShell 腳本, (s) 。
Syntax
# PowerShell on Target Machines v2
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@2
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.
輸入
EnvironmentName
- 機器
string
. 必要。
指定以逗號分隔的電腦 IP 位址或 FQDN 清單,以及埠。 預設埠是以選取的通訊協定為基礎。
例如: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
您也可以提供其他工作的輸出變數,例如 $(variableName)
。 如果您使用 HTTPS,電腦的名稱或 IP 應該符合憑證中的 CN。
AdminUserName
- 管理員登入
string
.
指定目的電腦的系統管理員登入。
例如:Domain\Admin User
、Admin User@Domain
、.\Admin User
。
AdminPassword
- 密碼
string
.
指定目的電腦的系統管理員密碼。 接受在組建/發行定義 $(passwordVariable)
中定義的變數。 您可以將變數類型標示為 secret
來保護它。
Protocol
- 協定
string
. 允許的值: Http
、 Https
。
指定要用於與電腦 () 之 WinRM 服務連線的通訊協定。 預設值是 HTTPS
。
TestCertificate
- 測試憑證
boolean
. 選擇性。 使用 時 Protocol = Https
。 預設值:true
。
指定選項,以略過受信任的憑證授權單位單位驗證電腦憑證的真實性。 WinRM HTTPS 通訊協定需要 參數。
ScriptPath
- PowerShell 腳本
string
. 必要。
指定目的機器或 UNC 路徑上 PowerShell 腳本的位置,例如 C:\BudgetIT\Web\Deploy\Website.ps1
。
ScriptArguments
- 腳本引數
string
.
指定 PowerShell 腳本的引數。 可以是序數或具名參數,例如 -testParam
test。
InitializationScriptPath
- 初始化腳本
string
.
指定目的機器或 UNC 路徑上 DSC 的資料腳本位置,例如 C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1
。
SessionVariables
- 會話變數
string
.
指定這兩個腳本的通用會話變數。 例如,$variable = value
或 $var1 = "value, 123"
。
RunPowershellInParallel
- 平行執行 PowerShell
boolean
. 預設值:true
。
如果設定為 true
,請在目的電腦上平行執行 PowerShell 腳本。
ResourceFilteringMethod
- 選取機器依據
string
. 允許的值: machineNames
(電腦名稱稱) , tags
。 預設值:machineNames
。
選擇性。 藉由提供電腦名稱稱或標籤來指定機器的子集。
MachineNames
- 篩選準則
string
.
此輸入僅適用于電腦群組或輸出變數。 尚未支援一般電腦清單。
指定電腦的清單,例如 dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
或 標籤,例如 Role:DB; OS:Win8.1
。 如果指定多個標記,工作將會在所有具有指定標籤的機器中執行。 預設會在所有機器中執行工作。
工作控制項選項
除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制選項和一般工作屬性。
輸出變數
無。
備註
2.0 版的新功能:
- 已移除舊版 DTL 機器的支援。
規格需求
需求 | 描述 |
---|---|
管線類型 | YAML、傳統組建、傳統版本 |
在 上執行 | Agent、DeploymentGroup |
要求 | 無 |
Capabilities | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
可設定變數 | 任意 |
代理程式版本 | 1.104.0 或更新版本 |
工作類別 | 部署 |