Dela via


PowerShellOnTargetMachines@1 – PowerShell på uppgift för måldatorer v1

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

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.

Indata

EnvironmentName - Maskiner
string. Krävs.

Anger en kommaavgränsad lista över datorns IP-adresser eller FQDN tillsammans med portar. Standardporten baseras på det valda protokollet.
Exempelvis: 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 namnet eller IP-adressen för datorn matcha CN i certifikatet.


AdminUserName - Admin inloggning
string.

Anger administratörsinloggningen för måldatorerna.


AdminPassword - Lösenord
string.

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


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

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


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

Hoppar över att verifiera äktheten för datorns certifikat av en betrodd certifikatutfärdare. Parametern krävs för WinRM HTTPS-protokollet.


ScriptPath - PowerShell-skript
string. Krävs.

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 vanliga sessionsvariabler för båda skripten. Exempel: $variable = value eller $var1 = "value, 123".


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

Om värdet är true, körs 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 datorerna genom att ange datornamn eller taggar.


MachineNames - Filtervillkor
string.

Dessa indata är endast giltiga 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. Standardinställningen kör aktiviteten på alla datorer.


Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 1.104.0 eller senare
Uppgiftskategori Distribuera