PowerShellOnTargetMachines@1– Aufgabe "PowerShell auf Zielcomputern v1"

Artikel
07/02/2024

Verwenden Sie diese Aufgabe zum Ausführen von PowerShell-Skripts auf Remotecomputern.

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.

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 angeben, 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.

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-Verbindung mit den Computern verwendet werden soll. Standardwert: HTTPS.

TestCertificate - Testzertifikat
boolean. Optional. Verwenden Sie , wenn Protocol = Https. Standardwert. true.

Überspringt die Überprüfung der Echtheit des Computerzertifikats durch eine vertrauenswürdige Zertifizierungsstelle. 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 wie C:\BudgetIT\Web\Deploy\Website.ps1an.

ScriptArguments - Skriptargumente
string.

Gibt die Argumente für das PowerShell-Skript an. Dies 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, werden die PowerShell-Skripts parallel auf den Zielcomputern ausgeführt.

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

Optional. Gibt eine Teilmenge der Computer an, indem Computernamen oder Tags angegeben 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 dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 . B. 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 die Aufgabe auf allen Computern ausgeführt.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.104.0 oder höher
Aufgabenkategorie	Bereitstellen

Freigeben über