Dela via

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.

Ingångar

scriptType - typ
string. Obligatoriskt. Tillåtna värden: inlineScript (infogat skript), filePath (filsökväg). Standardvärde: filePath.

Anger typ av skript för uppgiften 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 uppgiften som ska köras: ett infogat skript eller en sökväg till en .ps1 fil.


arguments - argument
string.

Anger argumenten 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 $(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

Ingen.

Anmärkningar

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 endast under hela jobbet där den körs. Uppgifter som är beroende av vad som har bootstrapped måste vara i samma jobb som bootstrap.

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 skript, 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 kan du till exempel:

./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
kräver Lokalt installerade agenter måste ha funktioner som matchar följande kräver för att köra jobb som använder den här uppgiften: DotNetFramework
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion 1.102 eller senare
Aktivitetskategori Nytta

Se även