Dela via

Om pwsh

  • Artikel

Kort beskrivning

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

Lång beskrivning

Syntax

pwsh[.exe]
   [[-File] <filePath> [args]]
   [-Command { - | <script-block> [-args <arg-array>]
                 | <string> [<CommandParameters>] } ]
   [-ConfigurationName <string>]
   [-CustomPipeName <string>]
   [-EncodedCommand <Base64EncodedCommand>]
   [-ExecutionPolicy <ExecutionPolicy>]
   [-InputFormat {Text | XML}]
   [-Interactive]
   [-NoExit]
   [-NoLogo]
   [-NonInteractive]
   [-NoProfile]
   [-OutputFormat {Text | XML}]
   [-SettingsFile <SettingsFilePath>]
   [-Version]
   [-WindowStyle <style>]
   [-WorkingDirectory <directoryPath>]

pwsh[.exe] -h | -Help | -? | /?

Parametrar

Alla parametrar är skiftlägesokänsliga.

-Fil | -F

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

Det här är standardparametern om det inte finns några parametrar men värden finns på kommandoraden. Det angivna skriptet körs i det lokala omfånget ("dot-sourced"), så att de funktioner och variabler som skriptet skapar är tillgängliga i den aktuella sessionen. Ange sökvägen till skriptfilen och eventuella parametrar. Filen måste vara den sista parametern i kommandot eftersom alla tecken som skrivits efter filparameternamnet tolkas som skriptfilens sökväg följt av skriptparametrarna.

Normalt inkluderas eller utelämnas växelparametrarna för ett skript. Följande kommando använder till exempel parametern Alla för 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 växelparameter. Om du vill ange ett booleskt värde för en växelparameter i värdet för parametern File använder du parametern som normalt följs omedelbart av ett kolon och det booleska värdet, till exempel följande: -File .\Get-Script.ps1 -All:$False.

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 syntaxen cmd.exe : pwsh -File .\test.ps1 -TestParam %windir%

Om du däremot kör pwsh -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. Stilen $env:windir för miljövariabelreferensen 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, använder %~dp0 du i stället för .\ eller $PSScriptRoot för att representera den aktuella körningskatalogen: pwsh -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 literala sökvägen .\test.ps1

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

-CommandPå samma sätt som när ett skriptavslutande fel inträffar är slutkoden inställd på 1. Men till skillnad från -Command, när körningen avbryts med Ctrl-C är 0slutkoden .

-Kommando | -C

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äser du kommandotexten från standardindata.

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

pwsh -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 exakt 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å skriptblocket 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:

pwsh -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 den 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äser du kommandotexten från standardindata. Du måste omdirigera standardindata när du använder kommandoparametern med standardindata. Exempel:

@'
"in"

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

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

I det här exemplet genereras följande utdata:

in
hi there
out

Processens slutkod bestäms av status för det sista 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.

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

Anger en konfigurationsslutpunkt där PowerShell körs. Detta 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ändarrollen.

Exempel: pwsh -ConfigurationName AdminRoles

-CustomPipeName

Anger namnet som ska användas för ytterligare en IPC-server (namngiven pipe) som används för felsökning och annan kommunikation mellan processer. Detta ger en förutsägbar mekanism för att ansluta till andra PowerShell-instanser. Används vanligtvis med parametern CustomPipeName på Enter-PSHostProcess.

Den här parametern introducerades i PowerShell 6.2.

Exempel:

# PowerShell instance 1
pwsh -CustomPipeName mydebugpipe
# PowerShell instance 2
Enter-PSHostProcess -CustomPipeName mydebugpipe

-EncodedCommand | -e | -Eg

Accepterar en Base64-kodad strängversion av ett kommando. Använd den här parametern för att skicka kommandon till PowerShell som kräver komplex, kapslad citat. Base64-representationen måste vara en UTF-16-kodad sträng.

Exempel:

$command = 'dir "c:\program files" '
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
pwsh -encodedcommand $encodedCommand

-ExecutionPolicy | -ex | -Ep

Anger standardkörningsprincipen för den aktuella sessionen och sparar den i $env:PSExecutionPolicyPreference miljövariabeln. Den här parametern ändrar inte de beständigt konfigurerade körningsprinciperna.

Den här parametern gäller endast för Windows-datorer. Miljövariabeln $env:PSExecutionPolicyPreference finns inte på plattformar som inte är Windows-plattformar.

-InputFormat | -in | -Om

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

-Interaktiv | -I

Presentera en interaktiv uppmaning för användaren. Invertera för parametern NonInteractive.

-NoExit | -Noe

Avslutas inte när startkommandon har körts.

Exempel: pwsh -NoExit -Command Get-Date

-NoLogo | -Nol

Döljer upphovsrättsbanderollen vid start av interaktiva sessioner.

-NonInteractive | -Noni

Visar ingen interaktiv uppmaning för användaren. Alla försök att använda interaktiva funktioner, till exempel Read-Host eller bekräftelsemeddelanden, resulterar i instruktionsslutfel.

-NoProfile | -Nop

Läser inte in PowerShell-profilerna.

-OutputFormat | -o | -Av

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

Exempel: pwsh -o XML -c Get-Date

När du anropas med en PowerShell-session får du deserialiserade objekt som utdata ganska enkla strängar. När utdata anropas från andra gränssnitt formateras strängdata som CLIXML-text.

-InställningarFil | -Inställningar

Åsidosätter den systemomfattande powershell.config.json inställningsfilen för sessionen. Som standard läss systemomfattande inställningar från powershell.config.json i $PSHOME katalogen .

Observera att de här inställningarna inte används av slutpunkten som anges av -ConfigurationName argumentet .

Exempel: pwsh -SettingsFile c:\myproject\powershell.config.json

-SSHServerMode | -sshs

Används i sshd_config för att köra PowerShell som ett SSH-undersystem. Det är inte avsett eller stöds inte för någon annan användning.

-Version | -V

Visar versionen av PowerShell. Ytterligare parametrar ignoreras.

-WindowStyle | -W

Anger fönsterformatet för sessionen. Giltiga värden är Normal, Minimerad, Maximerad och Dold.

-WorkingDirectory | -Wd

Anger den första arbetskatalogen genom att köra vid start. En giltig PowerShell-filsökväg stöds.

Om du vill starta PowerShell i din hemkatalog använder du: pwsh -WorkingDirectory ~

-Hjälp-?/?

Visar hjälp för pwsh. Om du skriver ett pwsh-kommando i PowerShell förbereder du kommandoparametrarna med ett bindestreck (-), inte ett snedstreck (/).