PowerShellOnTargetMachines@1 - ターゲット マシン v1 タスクの PowerShell

このタスクを使用して、リモート コンピューターで PowerShell スクリプトを実行します。

# 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 プロトコルに必要です。

PowerShell スクリプトの ScriptPath -
string。 必須。

ターゲット コンピューターまたは UNC パス上の PowerShell スクリプトの場所 (C:\BudgetIT\Web\Deploy\Website.ps1など) を指定します。

ScriptArguments - スクリプト引数の
string。

PowerShell スクリプトの引数を指定します。 序数パラメーターまたは名前付きパラメーター (-testParam テストなど) を指定できます。

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など) を指定します。 複数のタグが指定されている場合、タスクは指定されたタグを持つすべてのマシンで実行されます。 既定では、すべてのマシンでタスクが実行されます。

なし。