PowerShellOnTargetMachines@2 – Aufgabe "PowerShell auf Zielcomputern v2"
Verwenden Sie diese Aufgabe, um PowerShell-Skripts auf Remotecomputern auszuführen.
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.
Eingaben
EnvironmentName
- Maschinen
string
. Erforderlich.
Gibt eine durch Trennzeichen getrennte Liste von Computer-IP-Adressen oder FQDNs zusammen mit Ports an. Der Standardport basiert auf dem ausgewählten Protokoll.
Beispiel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Sie können auch die Ausgabevariable anderer Aufgaben bereitstellen, z. B $(variableName)
. . Wenn Sie HTTPS verwenden, sollte der Name oder die IP-Adresse des Computers mit dem CN im Zertifikat übereinstimmen.
AdminUserName
- Admin Anmeldung
string
.
Gibt die Administratoranmeldung für die Zielcomputer an.
Beispiel: Domain\Admin User
, Admin User@Domain
, .\Admin User
.
AdminPassword
- Passwort
string
.
Gibt das Administratorkennwort für die Zielcomputer an. In Build-/Releasedefinitionen definierte Variablen werden akzeptiert $(passwordVariable)
. Sie können den Variablentyp als secret
zum Sichern markieren.
Protocol
- Protokoll
string
. Zulässige Werte: Http
, Https
.
Gibt das Protokoll an, das für die WinRM-Dienstverbindung mit den Computern verwendet werden soll. Standardwert: HTTPS
.
TestCertificate
- Zertifikat testen
boolean
. Optional. Verwenden Sie , wenn Protocol = Https
. Standardwert. true
.
Gibt die Option an, die Überprüfung der Echtheit des Zertifikats des Computers durch eine vertrauenswürdige Zertifizierungsstelle zu überspringen. Der Parameter ist für das WinRM-HTTPS-Protokoll erforderlich.
ScriptPath
- PowerShell-Skript
string
. Erforderlich.
Gibt den Speicherort des PowerShell-Skripts auf den Zielcomputern oder in einem UNC-Pfad an, z. B C:\BudgetIT\Web\Deploy\Website.ps1
. .
ScriptArguments
- Skriptargumente
string
.
Gibt die Argumente für das PowerShell-Skript an. Kann Ordnungsparameter oder benannte Parameter sein, z. B -testParam
. Test.
InitializationScriptPath
- Initialisierungsskript
string
.
Gibt den Speicherort des Datenskripts für DSC auf den Zielcomputern oder in einem UNC-Pfad wie C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1
an.
SessionVariables
- Sitzungsvariablen
string
.
Gibt die allgemeinen Sitzungsvariablen für beide Skripts an. Zum Beispiel: $variable = value
oder $var1 = "value, 123"
.
RunPowershellInParallel
- Paralleles Ausführen von PowerShell
boolean
. Standardwert. true
.
Wenn auf true
festgelegt ist, führt die PowerShell-Skripts parallel auf den Zielcomputern aus.
ResourceFilteringMethod
- Computer nach auswählen
string
. Zulässige Werte: machineNames
(Computernamen), tags
. Standardwert. machineNames
.
Optional. Gibt eine Teilmenge von Computern an, indem Computernamen oder Tags angegeben werden.
MachineNames
- Filterkriterien
string
.
Diese Eingabe ist nur für Computergruppen oder Ausgabevariablen gültig. Es wird noch nicht für eine flache Liste von Computern unterstützt.
Gibt eine Liste von Computern an, z. B dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34
. oder Tags, z. B Role:DB; OS:Win8.1
. . Wenn mehrere Tags angegeben werden, wird der Task auf allen Computern mit den angegebenen Tags ausgeführt. Standardmäßig wird der Task auf allen Computern ausgeführt.
Aufgabensteuerungsoptionen
Alle Aufgaben verfügen zusätzlich zu den Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.
Ausgabevariablen
Keine.
Hinweise
Neuerungen in Version 2.0:
- Unterstützung für ältere DTL-Computer wurde entfernt.
Anforderungen
Anforderung | BESCHREIBUNG |
---|---|
Pipelinetypen | YAML, Klassischer Build, klassische Version |
Wird ausgeführt auf | Agent, DeploymentGroup |
Forderungen | Keine |
Capabilities | Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag. |
Befehlseinschränkungen | Any |
Einstellbare Variablen | Any |
Agent-Version | 1.104.0 oder höher |
Aufgabenkategorie | Bereitstellen |