PowerShellOnTargetMachines@2 - PowerShell op doelmachines v2-taak

Artikel
2025-03-24

Gebruik deze taak om PowerShell-scripts uit te voeren op externe computers.

Syntaxis

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

Invoer

EnvironmentName - Machines
string. Verplicht.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van computers, samen met poorten. De standaardpoort is gebaseerd op het geselecteerde protocol.
Bijvoorbeeld: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
U kunt ook de uitvoervariabele van andere taken opgeven, bijvoorbeeld $(variableName). Als u HTTPS gebruikt, moet de naam of het IP-adres van de computer overeenkomen met de CN in het certificaat.

AdminUserName - aanmeldgegevens van beheerders
string.

Hiermee geeft u de beheerdersaanmelding voor de doelcomputers.
Bijvoorbeeld: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - wachtwoord
string.

Hiermee geeft u het beheerderswachtwoord voor de doelmachines. Variabelen die zijn gedefinieerd in build-/releasedefinities als $(passwordVariable) worden geaccepteerd. U kunt het variabeletype markeren als secret om het te beveiligen.

Protocol - Protocol
string. Toegestane waarden: Http, Https.

Hiermee geeft u het protocol dat moet worden gebruikt voor de WinRM-serviceverbinding met de machine(s). De standaardwaarde is HTTPS.

TestCertificate - certificaat testen
boolean. Facultatief. Gebruiken wanneer Protocol = Https. Standaardwaarde: true.

Hiermee geeft u de optie voor het overslaan van de echtheid van het certificaat van de machine door een vertrouwde certificeringsinstantie. De parameter is vereist voor het WinRM HTTPS-protocol.

ScriptPath - PowerShell-script
string. Verplicht.

Hiermee geeft u de locatie van het PowerShell-script op de doelcomputers of op een UNC-pad, zoals C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - scriptargumenten
string.

Hiermee geeft u de argumenten voor het PowerShell-script. Kan ordinale of benoemde parameters zijn, zoals -testParam test.

InitializationScriptPath - initialisatiescript
string.

Hiermee geeft u de locatie van het gegevensscript voor DSC op de doelcomputers of op een UNC-pad, zoals C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - sessievariabelen
string.

Hiermee geeft u de algemene sessievariabelen voor beide scripts. Bijvoorbeeld $variable = value of $var1 = "value, 123".

RunPowershellInParallel - PowerShell parallel uitvoeren
boolean. Standaardwaarde: true.

Als deze optie is ingesteld op true, worden de PowerShell-scripts parallel uitgevoerd op de doelcomputers.

ResourceFilteringMethod - Machines selecteren op
string. Toegestane waarden: machineNames (machinenamen), tags. Standaardwaarde: machineNames.

Facultatief. Hiermee geeft u een subset van machines op door computernamen of tags op te geven.

MachineNames - filtercriteria
string.

Deze invoer is alleen geldig voor machinegroepen of uitvoervariabelen. Het wordt nog niet ondersteund voor een platte lijst met machines.

Hiermee geeft u een lijst met machines, zoals dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 of tags, zoals Role:DB; OS:Win8.1. Als er meerdere tags zijn opgegeven, wordt de taak uitgevoerd op alle computers met de opgegeven tags. Met de standaardinstelling wordt de taak op alle computers uitgevoerd.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Wat is er nieuw in versie 2.0:

Ondersteuning van verouderde DTL-machines is verwijderd.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.104.0 of hoger
Taakcategorie	Implementeren

Delen via