PowerShellOnTargetMachines@2 - 目标计算机上的 PowerShell v2 任务
使用此任务在远程计算机上 () 执行 PowerShell 脚本。
语法
# 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. 必需。
指定 PowerShell 脚本在目标计算机或 UNC 路径上的位置，例如 C:\BudgetIT\Web\Deploy\Website.ps1。
ScriptArguments - 脚本参数
string.
指定 PowerShell 脚本的参数。 可以是序号或命名参数，如 -testParam test。
InitializationScriptPath - 初始化脚本
string.
指定 DSC 的数据脚本在目标计算机或 UNC 路径上的位置，例如 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 计算机的支持。