PowerShellOnTargetMachines@2 – PowerShell på måldatorer v2-uppgift

Artikel
2025-03-24

Använd den här uppgiften för att köra PowerShell-skript på fjärrdatorer.

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.

Ingångar

EnvironmentName - Datorer
string. Obligatoriskt.

Anger en kommaavgränsad lista över datorns IP-adresser eller FQDN tillsammans med portar. Standardporten baseras på det valda protokollet.
Till exempel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Du kan också ange utdatavariabeln för andra aktiviteter, till exempel $(variableName). Om du använder HTTPS ska datorns namn eller IP matcha CN i certifikatet.

AdminUserName - administratörsinloggning
string.

Anger administratörsinloggningen för måldatorerna.
Till exempel: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - Lösenord
string.

Anger administratörslösenordet för måldatorerna. Variabler som definieras i versionsdefinitioner som $(passwordVariable) godkänns. Du kan markera variabeltypen som secret för att skydda den.

Protocol - Protocol
string. Tillåtna värden: Http, Https.

Anger vilket protokoll som ska användas för WinRM-tjänstanslutningen med datorerna. Standardvärdet är HTTPS.

TestCertificate - testcertifikat
boolean. Valfritt. Använd när Protocol = Https. Standardvärde: true.

Anger alternativet att hoppa över verifieringen av datorns certifikat av en betrodd certifikatutfärdare. Parametern krävs för WinRM HTTPS-protokollet.

ScriptPath - PowerShell-skript
string. Obligatoriskt.

Anger platsen för PowerShell-skriptet på måldatorerna eller på en UNC-sökväg, till exempel C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - skriptargument
string.

Anger argumenten för PowerShell-skriptet. Kan vara ordningstal eller namngivna parametrar, till exempel -testParam test.

InitializationScriptPath - Initieringsskript
string.

Anger platsen för dataskriptet för DSC på måldatorerna eller på en UNC-sökväg, till exempel C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - sessionsvariabler
string.

Anger de vanliga sessionsvariablerna för båda skripten. Till exempel $variable = value eller $var1 = "value, 123".

RunPowershellInParallel - Kör PowerShell parallellt
boolean. Standardvärde: true.

Om värdet är inställt på truekör du PowerShell-skripten parallellt på måldatorerna.

ResourceFilteringMethod - Välj datorer efter
string. Tillåtna värden: machineNames (datornamn), tags. Standardvärde: machineNames.

Valfritt. Anger en delmängd av datorer genom att ange datornamn eller taggar.

MachineNames - filtervillkor
string.

Den här indatan är endast giltig för datorgrupper eller utdatavariabler. Det stöds inte för en platt lista över datorer ännu.

Anger en lista över datorer, till exempel dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 eller taggar, till exempel Role:DB; OS:Win8.1. Om flera taggar anges körs aktiviteten på alla datorer med de angivna taggarna. Standardvärdet kör uppgiften på alla datorer.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Nyheter i version 2.0:

Stöd för äldre DTL-datorer har tagits bort.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	1.104.0 eller senare
Aktivitetskategori	Gruppera

Dela via