PowerShellOnTargetMachines@1 - PowerShell op doelcomputers v1-taak

Artikel
05/16/2024

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

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.

Invoerwaarden

EnvironmentName - Machines
string. Vereist.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van de computer op, 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 - Beheer aanmelden
string.

Hiermee geeft u de beheerdersaanmelding voor de doelcomputers.

AdminPassword - Wachtwoord
string.

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

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

Hiermee geeft u het protocol te gebruiken voor de WinRM-verbinding met de machine(s). De standaardwaarde is HTTPS.

TestCertificate - Testcertificaat
boolean. Optioneel. Gebruik wanneer Protocol = Https. Standaardwaarde: true.

Hiermee wordt het valideren van de echtheid van het certificaat van de machine door een vertrouwde certificeringsinstantie overgeslagen. De parameter is vereist voor het WinRM HTTPS-protocol.

ScriptPath - PowerShell-script
string. Vereist.

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. Dit kunnen ordinale of benoemde parameters zijn, zoals -testParam een 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 dit is ingesteld op true, worden de PowerShell-scripts parallel uitgevoerd op de doelcomputers.

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

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

MachineNames - Filtercriteria
string.

Deze invoer is alleen geldig voor computergroepen 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. De standaardinstelling voert de taak uit op alle computers.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.104.0 of hoger
Taakcategorie	Implementeren

Share via