PowerShell@1 – PowerShell v1-uppgift

  • Artikel

Kör ett PowerShell-skript.

Syntax

# PowerShell v1
# Run a PowerShell script.
- task: PowerShell@1
  inputs:
    scriptType: 'filePath' # 'inlineScript' | 'filePath'. Required. Type. Default: filePath.
    scriptName: # string. Required when scriptType = filePath. Script Path. 
    #arguments: # string. Arguments. 
    #inlineScript: # string. Required when scriptType = inlineScript. Inline Script. 
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: true # boolean. Fail on Standard Error. Default: true.

Indata

scriptType - Typ
string. Krävs. Tillåtna värden: inlineScript (infogat skript) filePath (Filsökväg). Standardvärde: filePath.

Anger typ av skript för aktiviteten som ska köras: ett infogat skript eller en sökväg till en .ps1 fil.


scriptName - Skriptsökväg
string. Krävs när scriptType = filePath.

Anger typ av skript för aktiviteten som ska köras: ett infogat skript eller en sökväg till en .ps1 fil.


arguments - Argument
string.

Anger de argument som skickas till PowerShell-skriptet. Argument kan vara ordningsparametrar eller namngivna parametrar. Till exempel -Name someName -Path -Value "Some long string value".

arguments används inte när targetType är inställt på inline.


workingFolder - Arbetsmapp
string.

Anger arbetskatalogen där skriptet körs. Om inget värde anges är $(Build.SourcesDirectory)arbetskatalogen .


inlineScript - Infogat skript
string. Krävs när scriptType = inlineScript. Standardvärde: # You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host "Hello World".

Anger innehållet i skriptet. Den maximala längden på infogade skript som stöds är 500 tecken. Använd ett skript från en fil om du vill använda ett längre skript.


failOnStandardError - Fel vid standardfel
boolean. Standardvärde: true.

Om värdet för det här booleska värdet är truemisslyckas aktiviteten om några fel skrivs till felpipelinen eller om några data skrivs till standardfelströmmen. Annars förlitar sig uppgiften på slutkoden för att fastställa felet.


Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Kommentarer

PowerShell@1 körs endast på Windows-agenter. Om du vill köra PowerShell på andra agenttyper använder du PowerShell@2.

Varje PowerShell-session varar bara under hela jobbet som den körs i. Uppgifter som är beroende av vad som har bootstrappats måste finnas i samma jobb som bootstrap-metoden.

Ange en variabel så att den kan läsas av efterföljande skript och uppgifter

Mer information om hur du definierar byggvariabler i ett skript finns i Definiera och ändra dina byggvariabler i ett skript.

Mer information om hur du definierar versionsvariabler i ett skript finns i Definiera och ändra dina versionsvariabler i ett skript.

Skicka pipelinehemligheter i skriptet, men hemligheten maskeras inte i pipelineloggar

Tänk på att PowerShell stänger av felmeddelanden, så om du använder pipelinehemligheter i ett skript kan hemligheterna trimmas och exponeras. I det infogade skriptet nedan:

./script.ps1 --arg1 value1 --arg2 <some_secret_which_will_be_masked_here>

Det kan finnas ett undantag som: At <path_to_temp_script_file>:4 char:3

+   ./script.ps1 --arg1 value1 --arg2 <unmasked_part_of_original_secret> ...
+   ~~~~~~~~~~
    + <Additional exception details>

För att undvika det här problemet kan du hantera dessa undantag på skriptnivå eller undvika fall då pipelinehemligheter kan visas i källkodsrader i felmeddelanden.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: DotNetFramework
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.102 eller senare
Uppgiftskategori Verktyg

Se även