PowerShellOnTargetMachines@2 — задача PowerShell на целевых компьютерах версии 2

Используйте эту задачу для выполнения скриптов 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-адресов компьютера или полных доменных имен, а также портов. Порт по умолчанию основан на выбранном протоколе.
Например: 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.

Указывает параметр пропуска проверки подлинности сертификата компьютера доверенным центром сертификации. Параметр необходим для протокола HTTPS WinRM.


ScriptPath - скрипта PowerShell
string. Обязательное.

Указывает расположение скрипта PowerShell на целевых компьютерах или в пути UNC, например C:\BudgetIT\Web\Deploy\Website.ps1.


Аргументы скрипта ScriptArguments -
string.

Задает аргументы для скрипта PowerShell. Может быть порядковый или именованный параметр, например тест -testParam.


скрипта инициализации 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.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
требования Нет
возможностей Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд Любое
переменные settable Любое
Версия агента 1.104.0 или более поздней версии
Категория задач Внедрять