PowerShellOnTargetMachines@1 – PowerShell a Célgépek 1-ben feladat

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

Syntax

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

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 feladatok kimeneti változóját is megadhatja, például $(variableName). HA HTTPS-t használ, a gép nevének vagy IP-címének meg kell egyeznie a tanúsítvány CN-jének.

AdminUserName - Rendszergazda bejelentkezés
string.

Megadja a célgépek rendszergazdai bejelentkezését.

AdminPassword - Jelszó
string.

Megadja a célgépek rendszergazdai jelszavát. A build-/kiadási definíciókban definiált változók $(passwordVariable) elfogadottak. A változótípust biztonságosként secret jelölheti meg.

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

Meghatározza a gép(ek) WinRM-kapcsolatához használni kívánt 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.

Kihagyja a számítógép tanúsítványának megbízható hitelesítésszolgáltató általi hitelesítésének hitelesítését. 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.

A PowerShell-szkript argumentumait adja meg. 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ói
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 trueállítva, párhuzamosan futtatja a PowerShell-szkripteket a célgépeken.

ResourceFilteringMethod - Gépek kiválasztása
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.

Meghatározza az olyan gépek listáját, mint például dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 a vagy a 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.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

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 feladat 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