about_PowerShell_exe

  • Artikel

Kort beskrivning

Förklarar hur du använder kommandoradsgränssnittet powershell.exe . Visar kommandoradsparametrarna och beskriver syntaxen.

Lång beskrivning

Information om kommandoradsalternativen för PowerShell 7 finns i about_Pwsh.

SYNTAX

PowerShell[.exe]
    [-PSConsoleFile <file> | -Version <version>]
    [-NoLogo]
    [-NoExit]
    [-Sta]
    [-Mta]
    [-NoProfile]
    [-NonInteractive]
    [-InputFormat {Text | XML}]
    [-OutputFormat {Text | XML}]
    [-WindowStyle <style>]
    [-EncodedArguments <Base64EncodedArguments>]
    [-EncodedCommand <Base64EncodedCommand>]
    [-ConfigurationName <string>]
    [-File - | <filePath> <args>]
    [-ExecutionPolicy <ExecutionPolicy>]
    [-Command - | { <script-block> [-args <arg-array>] }
                | { <string> [<CommandParameters>] } ]

PowerShell[.exe] -Help | -? | /?

Parametrar

-Kommandot

Kör de angivna kommandona (och alla parametrar) som om de hade skrivits i PowerShell-kommandotolken och avslutas sedan, såvida inte parametern NoExit har angetts.

Värdet för Kommandot kan vara -, ett skriptblock eller en sträng. Om värdet för Kommandot är -, läss kommandotexten från standardindata.

Kommandoparametern accepterar endast ett skriptblock för körning när det kan identifiera värdet som skickas till Kommando som en ScriptBlock-typ. Detta är bara möjligt när du kör powershell.exe från en annan PowerShell-värd. ScriptBlock-typen kan finnas i en befintlig variabel, returneras från ett uttryck eller parsas av PowerShell-värden som ett literalskriptblock omgivet av klammerparenteser ({}), innan det skickas till powershell.exe.

powershell -Command {Get-WinEvent -LogName security}

I cmd.exefinns det inget sådant som ett skriptblock (eller ScriptBlock-typ), så värdet som skickas till Kommandot kommer alltid att vara en sträng. Du kan skriva ett skriptblock i strängen, men i stället för att köras fungerar det precis som om du skrev det i en vanlig PowerShell-prompt och skriver ut innehållet i skriptblocket tillbaka till dig.

En sträng som skickas till Kommandot körs fortfarande som PowerShell-kod, så skriptblockets klammerparenteser krävs ofta inte i första hand när du kör från cmd.exe. Om du vill köra ett infogat skriptblock som definierats i en sträng kan anropsoperatorn& användas:

powershell.exe -Command "& {Get-WinEvent -LogName security}"

Om värdet för Kommandot är en sträng måste kommandot vara den sista parametern för pwsh, eftersom alla argument som följer tolkas som en del av kommandot som ska köras.

När de anropas inifrån en befintlig PowerShell-session returneras resultatet till det överordnade gränssnittet som deserialiserade XML-objekt, inte levande objekt. För andra gränssnitt returneras resultatet som strängar.

Om värdet för Kommandot är -, läss kommandotexten från standardindata. Du måste omdirigera standardindata när du använder kommandoparametern med standardindata. Till exempel:

@'
"in"

"hi" |
  % { "$_ there" }

"out"
'@ | powershell -NoProfile -Command -

Det här exemplet genererar följande utdata:

in
hi there
out

Processens slutkod bestäms av status för det senaste kommandot (körs) i skriptblocket. Slutkoden är 0 när $? är $true eller 1 när $? är $false. Om det sista kommandot är ett externt program eller ett PowerShell-skript som uttryckligen anger en annan slutkod än 0 eller 1konverteras slutkoden till 1 för processens slutkod. Om du vill bevara den specifika slutkoden lägger du till exit $LASTEXITCODE i kommandosträngen eller skriptblocket.

Mer information $LASTEXITCODE finns i about_Automatic_Variables.

På samma sätt returneras värdet 1 när ett skriptavslutande (runspace-terminerande) fel, till exempel ett throw eller -ErrorAction Stop, inträffar eller när körningen avbryts med Ctrl+C.

-ConfigurationName-sträng <>

Anger en konfigurationsslutpunkt där PowerShell körs. Det kan vara vilken slutpunkt som helst som är registrerad på den lokala datorn, inklusive standardslutpunkterna för PowerShell-fjärrkommunikation eller en anpassad slutpunkt som har specifika funktioner för användarroller.

-EncodedArguments <Base64EncodedArguments>

Accepterar kommandoargument för base64-kodad strängversion. Använd den här parametern för att skicka argument som kräver komplex, kapslad citat. Base64-representationen måste vara en UTF-16LE-kodad sträng.

-EncodedCommand <Base64EncodedCommand>

Accepterar en base-64-kodad strängversion av ett kommando. Använd den här parametern för att skicka kommandon till PowerShell som kräver komplexa citattecken eller klammerparenteser. Strängen måste formateras med utf-16LE-teckenkodning.

-ExecutionPolicy <ExecutionPolicy>

Anger standardkörningsprincipen för den aktuella sessionen och sparar den i $env:PSExecutionPolicyPreference miljövariabeln. Den här parametern ändrar inte PowerShell-körningsprincipen som anges i registret. Information om PowerShell-körningsprinciper, inklusive en lista med giltiga värden, finns i about_Execution_Policies.

-File - | <Filepath><Args>

Om värdet för Fil är -läss kommandotexten från standardindata. Om du kör powershell -File - utan omdirigerade standardindata startas en vanlig session. Det här är samma sak som att inte ange parametern File alls .

Om värdet för Fil är en filsökväg körs skriptet i det lokala omfånget ("dot-sourced") för den nya sessionen, så att de funktioner och variabler som skriptet skapar är tillgängliga i den nya sessionen. Ange skriptfilsökvägen och eventuella parametrar. Filen måste vara den sista parametern i kommandot. Alla värden som skrivs efter filparametern tolkas som skriptfilens sökväg och parametrar som skickas till skriptet.

Parametrar som skickas till skriptet skickas som literalsträngar efter tolkning av det aktuella gränssnittet. Om du till exempel är i cmd.exe och vill skicka ett miljövariabelvärde använder du cmd.exe syntax:powershell.exe -File .\test.ps1 -TestParam %windir%

Om du däremot kör powershell.exe -File .\test.ps1 -TestParam $env:windir i cmd.exe resulterar det i att skriptet tar emot literalsträngen $env:windir eftersom den inte har någon särskild betydelse för det aktuella cmd.exe-gränssnittet . Referensen $env:windir för miljövariabeln kan användas i en kommandoparameter , eftersom den tolkas som PowerShell-kod.

På samma sätt, om du vill köra samma kommando från ett Batch-skript, skulle du använda %~dp0 i stället för .\ eller $PSScriptRoot för att representera den aktuella körningskatalogen: powershell.exe -File %~dp0test.ps1 -TestParam %windir%. Om du i stället använde .\test.ps1skulle PowerShell utlösa ett fel eftersom det inte går att hitta den bokstavliga sökvägen .\test.ps1

När värdet för Fil är en filsökväg måste Filenvara den sista parametern i kommandot eftersom alla tecken som skrivs efter filparameternamnet tolkas som skriptfilsökvägen följt av skriptparametrarna.

Du kan inkludera skriptparametrar och värden i värdet för filparametern. Till exempel: -File .\Get-Script.ps1 -Domain Central

Normalt inkluderas eller utelämnas växelparametrarna för ett skript. Följande kommando använder till exempel parametern Alla i Get-Script.ps1 skriptfilen: -File .\Get-Script.ps1 -All

I sällsynta fall kan du behöva ange ett booleskt värde för en parameter. Det går inte att skicka ett explicit booleskt värde för en växelparameter när du kör ett skript på det här sättet. Den här begränsningen har tagits bort i PowerShell 6 (pwsh.exe).

Kommentar

Parametern File kan inte stödja skript med hjälp av en parameter som förväntar sig en matris med argumentvärden. Detta är tyvärr en begränsning av hur ett internt kommando hämtar argumentvärden. När du anropar en intern körbar fil (till exempel powershell eller pwsh) vet den inte vad den ska göra med en matris, så den skickas som en sträng.

När skriptfilen avslutas med ett exit kommando anges processens slutkod till det numeriska argumentet som används med exit kommandot . Med normal avslutning är slutkoden alltid 0.

Mer information $LASTEXITCODE finns i about_Automatic_Variables.

-InputFormat {Text | XML}

Beskriver formatet för data som skickas till PowerShell. Giltiga värden är Text (textsträngar) eller XML (serialiserat CLIXML-format).

-Mta

Startar PowerShell med en flertrådad lägenhet. Den här parametern introduceras i PowerShell 3.0. I PowerShell 2.0 är multitrådad lägenhet (MTA) standard. I PowerShell 3.0 är entrådad lägenhet (STA) standard.

-NoExit

Avslutas inte efter att startkommandon har körts.

-NonInteractive

Den här växeln används för att skapa sessioner som inte ska kräva användarindata. Detta är användbart för skript som körs i schemalagda aktiviteter eller CI/CD-pipelines. Alla försök att använda interaktiva funktioner, till exempel Read-Host eller bekräftelsemeddelanden, resulterar i att instruktionen avslutar fel i stället för hängande.

Döljer upphovsrättsbanderollen vid start.

-NoProfile

Läser inte in PowerShell-profilen.

-OutputFormat {Text | XML}

Avgör hur utdata från PowerShell formateras. Giltiga värden är Text (textsträngar) eller XML (serialiserat CLIXML-format).

-PSConsoleFile <FilePath>

Läser in den angivna PowerShell-konsolfilen. Ange sökvägen och namnet på konsolfilen. Om du vill skapa en konsolfil använder du cmdleten Export-Console i PowerShell.

-Sta

Startar PowerShell med en entrådad lägenhet. I Windows PowerShell 2.0 är multitrådad lägenhet (MTA) standard. I Windows PowerShell 3.0 är entrådad lägenhet (STA) standard.

-Version <PowerShell-version>

Startar den angivna versionen av PowerShell. Giltiga värden är 2.0 och 3.0. Den version som du anger måste vara installerad på systemet. Om Windows PowerShell 3.0 är installerat på datorn är "3.0" standardversionen. Annars är "2.0" standardversionen. För mer information, se Installera PowerShell.

-WindowStyle <Window-formatmall>

Anger fönsterformatet för sessionen. Giltiga värden är Normal, Minimized, Maximizedoch Hidden.

-Hjälp-?/?

Visar hjälp för PowerShell.exe. Om du skriver ett PowerShell.exe kommando i en PowerShell-session förbereder du kommandoparametrarna med ett bindestreck (-), inte ett snedstreck (/). Du kan använda antingen ett bindestreck eller snedstreck i cmd.exe.

REMARKS

Felsökningsanteckning: I PowerShell 2.0 misslyckas start av vissa program från PowerShell-konsolen med ett LastExitCode-0xc0000142 .

EXEMPEL

# Create a new PowerShell session and load a saved console file
PowerShell -PSConsoleFile sqlsnapin.psc1

# Create a new PowerShell V2 session with text input, XML output, and no logo
PowerShell -Version 2.0 -NoLogo -InputFormat text -OutputFormat XML

# Execute a PowerShell Command in a session
PowerShell -Command "Get-EventLog -LogName security"

# Run a script block in a session
PowerShell -Command {Get-EventLog -LogName security}

# An alternate way to run a command in a new session
PowerShell -Command "& {Get-EventLog -LogName security}"

# To use the -EncodedCommand parameter:
$command = "dir 'c:\program files' "
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
powershell.exe -encodedCommand $encodedCommand