PowerShellOnTargetMachines@2 – Aufgabe "PowerShell auf Zielcomputern v2"

Artikel
07/02/2024

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

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

Freigeben über