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