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 或更新版本
工作類別 部署