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

Статья
07/02/2024

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

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

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

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

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

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

Нет.

Требования

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

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