PowerShellOnTargetMachines@2 – PowerShell auf Zielcomputern v2-Aufgabe

Artikel
03/24/2025

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.

Eingänge

EnvironmentName - Computer
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 des Computers mit dem CN im Zertifikat übereinstimmen.

AdminUserName - Administratoranmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.
Beispiel: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - Kennwort
string.

Gibt das Administratorkennwort für die Zielcomputer an. Variablen, die in Build-/Releasedefinitionen als $(passwordVariable) definiert sind, werden akzeptiert. Sie können den Variablentyp als secret markieren, um ihn zu sichern.

Protocol - Protokoll-
string. Zulässige Werte: Http, Https.

Gibt das Protokoll an, das für die WinRM-Dienstverbindung mit den Computern verwendet werden soll. Der Standardwert ist HTTPS.

TestCertificate - Testzertifikat
boolean. Wahlfrei. Wird verwendet, wenn Protocol = Https. Standardwert: true.

Gibt die Option an, die Gültigkeit 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 auf 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 ordinal oder benannte Parameter sein, z. B. -testParam Test.

InitializationScriptPath - Initialisierungsskript-
string.

Gibt den Speicherort des Datenskripts für DSC auf den Zielcomputern oder auf einem UNC-Pfad an, z. B. C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Sitzungsvariablen
string.

Gibt die allgemeinen Sitzungsvariablen für beide Skripts an. Beispiel: $variable = value oder $var1 = "value, 123".

RunPowershellInParallel - PowerShell parallel ausführen
boolean. Standardwert: true.

Bei Festlegung auf truewerden die PowerShell-Skripts auf den Zielcomputern parallel ausgeführt.

ResourceFilteringMethod - Computer nach auswählen
string. Zulässige Werte: machineNames (Computernamen), tags. Standardwert: machineNames.

Wahlfrei. Gibt eine Teilmenge von Computern an, indem Computernamen oder -tags bereitgestellt werden.

MachineNames - Filterkriterien
string.

Diese Eingabe ist nur für Computergruppen oder Ausgabevariablen gültig. Es wird für eine flache Liste von Computern noch nicht 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 sind, wird die Aufgabe auf allen Computern mit den angegebenen Tags ausgeführt. Standardmäßig wird die Aufgabe auf allen Computern ausgeführt.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Neuerungen in Version 2.0:

Unterstützung von älteren DTL-Computern entfernt.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.104.0 oder höher
Vorgangskategorie	Einsetzen

Teilen über