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

Статья
07/02/2024

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

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

Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Новые возможности версии 2.0:

Удалена поддержка устаревших компьютеров DTL.

Требования

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

Поделиться через