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

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.

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 datorns namn eller IP matcha CN i certifikatet.


AdminUserName - Admin inloggning
string.

Anger administratörsinloggning 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) 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-tjänstanslutningen till 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. 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 det är inställt truepå kö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 datorerna 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 än.

Anger en lista över datorer, till exempel dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 eller taggar, som 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.


Alternativ för aktivitetskontroll

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

Utdatavariabler

Inga.

Kommentarer

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