PowerShellOnTargetMachines@2 – PowerShell a Célgépek v2-n feladat

Ezzel a feladatsal PowerShell-szkripteket hajthat végre távoli gépeken.

Syntax

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

Bevitelek

EnvironmentName - Gépek
string. Kötelező.

A gép IP-címeinek vagy teljes tartományneveinek vesszővel tagolt listáját adja meg a portokkal együtt. Az alapértelmezett port a kiválasztott protokollon alapul.
Például: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Más tevékenységek kimeneti változóját is megadhatja, például $(variableName): . HTTPS használata esetén a gép nevének vagy IP-címének meg kell egyeznie a tanúsítvány cn-jének nevével.

AdminUserName - Rendszergazda bejelentkezés
string.

Megadja a célgépek rendszergazdai bejelentkezését.
Például: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - Jelszó
string.

Megadja a célgépek rendszergazdai jelszavát. A build-/kiadási definíciókban elfogadott változók $(passwordVariable) . A változótípust biztonságossá secret teheti.

Protocol - Protokoll
string. Engedélyezett értékek: Http, Https.

Meghatározza a WinRM szolgáltatás és a gép(ek) közötti kapcsolathoz használandó protokollt. Az alapértelmezett érték HTTPS.

TestCertificate - Tanúsítvány tesztelése
boolean. Választható. Használja a következőt: Protocol = Https. Alapértelmezett érték: true.

Itt adhatja meg, hogy a számítógép tanúsítványának hitelességét egy megbízható hitelesítésszolgáltató ne érvényesítse. A paraméter a WinRM HTTPS protokollhoz szükséges.

ScriptPath - PowerShell-szkript
string. Kötelező.

Megadja a PowerShell-szkript helyét a célgépeken vagy egy UNC elérési úton, például C:\BudgetIT\Web\Deploy\Website.ps1: .

ScriptArguments - Szkriptargumentumok
string.

Megadja a PowerShell-szkript argumentumait. Lehetnek sorszámos vagy elnevezett paraméterek, például -testParam teszt.

InitializationScriptPath - Inicializálási szkript
string.

Megadja a DSC adatszkriptjének helyét a célgépeken vagy egy UNC elérési úton, például C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1: .

SessionVariables - Munkamenet-változók
string.

Mindkét szkript gyakori munkamenet-változóit határozza meg. Például $variable = value vagy $var1 = "value, 123".

RunPowershellInParallel - A PowerShell párhuzamos futtatása
boolean. Alapértelmezett érték: true.

Ha a értékre van állítva, truepárhuzamosan futtatja a PowerShell-szkripteket a célgépeken.

ResourceFilteringMethod - Gépek kiválasztása a következő szerint:
string. Engedélyezett értékek: machineNames (Gépnevek), tags. Alapértelmezett érték: machineNames.

Választható. Gépnevek vagy címkék megadásával adja meg a gépek egy részhalmazát.

MachineNames - Szűrési feltételek
string.

Ez a bemenet csak gépcsoportokra vagy kimeneti változókra érvényes. Egyelőre nem támogatott a gépek egybesimított listája.

Megadja a gépek listáját, például dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 vagy címkéket, például Role:DB; OS:Win8.1: . Ha több címke van megadva, a feladat a megadott címkékkel rendelkező összes gépen futni fog. Az alapértelmezett beállítás az összes gépen futtatja a feladatot.

Tevékenységvezérlési beállítások

A tevékenységbemeneteken kívül minden tevékenység rendelkezik vezérlési lehetőségekkel. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

A 2.0-s verzió újdonságai:

• Az örökölt DTL-gépek támogatása megszűnt.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.104.0 vagy újabb
Feladatkategória	Üzembe helyezés