次の方法で共有


PowerShellOnTargetMachines@2 - ターゲット マシン v2 タスクの PowerShell

このタスクを使用して、リモート コンピューターで 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 UserAdmin User@Domain.\Admin User


AdminPassword - パスワード
string

ターゲット マシンの管理者パスワードを指定します。 $(passwordVariable) としてビルド/リリース定義で定義された変数が受け入れられます。 変数の型は、セキュリティで保護するために secret としてマークできます。


Protocol - プロトコル
string。 使用できる値: HttpHttps

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


タスク コントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。

出力変数

なし。

注釈

バージョン 2.0 の新機能:

  • 従来の DTL マシンのサポートが削除されました。

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
の需要 なし
機能の このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 どれでも
設定可能な変数 どれでも
エージェントのバージョン 1.104.0 以上
タスク カテゴリ 展開