PowerShellOnTargetMachines@1 - 目標機器 v1 工作上的 PowerShell

  • 發行項

使用此工作在遠端電腦上執行 PowerShell 腳本， (s) 。

Syntax

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

輸入

EnvironmentName - 機器
string. 必要。

指定以逗號分隔的電腦IP位址或 FQDN 清單，以及埠。 預設埠是以選取的通訊協議為基礎。
例如：dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
您也可以提供其他工作的輸出變數，例如 $(variableName)。 如果您使用 HTTPS，計算機的名稱或 IP 應該符合憑證中的 CN。


AdminUserName - 管理員 登入
string.

指定目標計算機的系統管理員登入。


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。 如果指定多個標記，工作將會在所有具有指定標籤的機器中執行。 預設會在所有機器中執行工作。


工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

規格需求

需求 描述
管線類型 YAML、傳統組建、傳統版本
在上執行 Agent、DeploymentGroup
要求 無
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任何
可設定變數 任何
代理程式版本 1.104.0 或更新版本
工作類別 部署