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 true
på 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 |