PowerShellOnTargetMachines@2 – Úloha PowerShellu na cílových počítačích v2

Pomocí této úlohy můžete na vzdálených počítačích spouštět skripty PowerShellu.

Syntaxe

# 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.

Vstupy

EnvironmentName - Stroje
string. Povinné.

Určuje čárkami oddělený seznam IP adres počítače nebo plně kvalifikovaných názvů domén spolu s porty. Výchozí port je založený na vybraném protokolu.
Příklad: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Můžete také zadat výstupní proměnnou jiných úloh, například $(variableName). Pokud používáte HTTPS, název nebo IP adresa počítače by se měly shodovat s cn v certifikátu.

přihlášení správce AdminUserName -
string.

Určuje přihlášení správce pro cílové počítače.
Například: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - heslo
string.

Určuje heslo správce pro cílové počítače. Proměnné definované v definicích sestavení/vydané verze se přijímají $(passwordVariable). Typ proměnné můžete označit jako secret, abyste ho zabezpečili.

protokolu Protocol -
string. Povolené hodnoty: Http, Https.

Určuje protokol, který se má použít pro připojení služby WinRM k počítačům. Výchozí hodnota je HTTPS.

TestCertificate - testovacího certifikátu
boolean. Volitelný. Používá se při Protocol = Https. Výchozí hodnota: true.

Určuje možnost přeskočit ověření pravosti certifikátu počítače důvěryhodnou certifikační autoritou. Parametr se vyžaduje pro protokol HTTPS WinRM.

ScriptPath - skript PowerShellu
string. Povinné.

Určuje umístění skriptu PowerShellu na cílových počítačích nebo v cestě UNC, například C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - argumenty skriptu
string.

Určuje argumenty pro skript PowerShellu. Může to být řadový nebo pojmenovaný parametr, například -testParam test.

InitializationScriptPath - inicializační skript
string.

Určuje umístění datového skriptu pro DSC na cílových počítačích nebo v cestě UNC, například C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - proměnné relace
string.

Určuje společné proměnné relace pro oba skripty. Například $variable = value nebo $var1 = "value, 123".

RunPowershellInParallel - spuštění PowerShellu paralelně
boolean. Výchozí hodnota: true.

Pokud je nastavená na true, spustí powershellové skripty paralelně na cílových počítačích.

ResourceFilteringMethod - Vybrat počítače podle
string. Povolené hodnoty: machineNames (názvy počítačů), tags. Výchozí hodnota: machineNames.

Volitelný. Určuje podmnožinu počítačů zadáním názvů nebo značek počítačů.

MachineNames - kritéria filtru
string.

Tento vstup je platný pouze pro skupiny počítačů nebo výstupní proměnné. Pro plochý seznam počítačů se zatím nepodporuje.

Určuje seznam počítačů, jako jsou dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 nebo značky, například Role:DB; OS:Win8.1. Pokud je zadáno více značek, úloha se spustí na všech počítačích se zadanými značkami. Ve výchozím nastavení se úloha spouští na všech počítačích.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Novinky ve verzi 2.0:

• Odebrali jsme podporu starších počítačů DTL.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.104.0 nebo vyšší
Kategorie úkolu	Nasadit