Om_Parsning

Kort beskrivning

Beskriver hur PowerShell parsar kommandon.

Lång beskrivning

När du anger ett kommando i kommandotolken delar PowerShell upp kommandotexten i en serie segment som kallas token och bestämmer sedan hur varje token ska tolkas.

Om du till exempel skriver:

Write-Host book

PowerShell delar upp kommandot i två token, Write-Host och book, och tolkar varje token oberoende av varandra med något av två huvudsakliga parsningslägen: uttrycksläge och argumentläge.

Anmärkning

När PowerShell parsar kommandoindata försöker det matcha kommandonamnen till cmdletar eller inbyggda körbara filer. Om ett kommandonamn inte har en exakt matchning lägger Get- PowerShell till kommandot som ett standardverb. PowerShell parsar till exempel Process som Get-Process. Vi rekommenderar inte att du använder den här funktionen av följande skäl:

• Det är ineffektivt. Detta gör att PowerShell söker flera gånger.
• Externa program med samma namn matchas först, så du kanske inte kör den avsedda cmdleten.
• Get-Help och Get-Command känner inte igen verblösa namn.

Uttrycksläge

Uttrycksläget är avsett för att kombinera uttryck som krävs för värdemanipulering på ett skriptspråk. Uttryck är representationer av värden i PowerShell-syntax och kan vara enkla eller sammansatta, till exempel:

Literaluttryck är direkta representationer av deras värden:

'hello'
32

Variabeluttryck har värdet för variabeln som de refererar till:

$x
$script:path

Operatorer kombinerar andra uttryck för utvärdering:

-12
-not $Quiet
3 + 7
$input.Length -gt 1

• Teckensträngliteraler måste finnas inom citattecken.
• Tal behandlas som numeriska värden i stället för som en serie tecken (om de inte är undantagna).
• Operatorer, inklusive unära operatorer som - och -not och binära operatorer som + och -gt, tolkas som operatorer och utför sina respektive operationer på sina argument (operander).
• Attribut- och konverteringsuttryck tolkas som uttryck och tillämpas på underordnade uttryck, t.ex. [int] '7'
• Variabelreferenser utvärderas till sina värden, men splatting (d.v.s. att klistra in förifyllda parameteruppsättningar) är förbjudet och orsakar ett parserfel.
• Allt annat kommer att behandlas som ett kommando som ska anropas.

Argumentläge

Vid parsning ser PowerShell först ut att tolka indata som ett uttryck. Men när ett kommandoanrop påträffas fortsätter parsningen i argumentläge. Om du har argument som innehåller mellanslag, till exempel sökvägar, måste du omge argumentvärdena med citattecken.

Argumentläget är utformat för att parsa argument och parametrar för kommandon i en gränssnittsmiljö. Alla indata behandlas som en expanderbar sträng om den inte använder någon av följande syntaxer:

• Dollartecken ($) följt av ett variabelnamn inleder en variabelreferens, annars tolkas den som en del av den expanderbara strängen. Variabelreferensen kan innehålla medlemsåtkomst eller indexering.

  • Ytterligare tecken som följer enkla variabelreferenser, till exempel $HOME, anses vara en del av samma argument. Omslut variabelnamnet i klammerparenteser ({}) för att skilja det från efterföljande tecken. Till exempel ${HOME}.
  • När variabelreferensen innehåller medlemsåtkomst betraktas det första av eventuella ytterligare tecken som början på ett nytt argument. Till exempel resulterar $HOME.Length-more i två argument: värdet för $HOME.Length och strängliteral -more.

• Citattecken (' och ") börjar strängar

• Klammerparenteser ({}) börjar ett nytt skriptblock

• Kommatecken (,) introducerar listor som skickas som arrayer, förutom när kommandot som ska anropas är ett internt program, i vilket fall de tolkas som en del av den expanderbara strängen. Första, efterföljande eller avslutande kommatecken stöds inte.

• Parenteser (()) påbörjar ett nytt uttryck

• Underuttrycksoperatorn ($()) påbörjar ett inbäddat uttryck

• Initialstecknet (@) börjar syntax för uttryck som splatting (@args), arrayer (@(1,2,3)) och hashtabellitteraler (@{a=1;b=2}).

• (), $()och @() i början av en token skapar du en ny parsningskontext som kan innehålla uttryck eller kapslade kommandon.

  • När det följs av ytterligare tecken anses det första ytterligare tecknet vara början på ett nytt, separat argument.
  • När den föregås av en literal $() utan citattecken fungerar den som en expanderbar sträng, () startar ett nytt argument som är ett uttryck och @() tas som literal @ när () ett nytt argument som är ett uttryck startas.

• Allt annat behandlas som en expanderbar sträng, förutom metakarakterare som fortfarande behöver fly.

  • Metakarakterarna för argumentläge (tecken med särskild syntaktisk betydelse) är: <space> ' " ` , ; ( ) { } | & < > @ #. Av dessa är < > @ # bara speciella i början av en token.

• Token för stoppparsning (--%) ändrar tolkningen av alla återstående argument. Mer information finns i avsnittet stop-parsing token nedan.

Exempel

I följande tabell finns flera exempel på token som bearbetas i uttrycksläge och argumentläge samt utvärdering av dessa token. För dessa exempel är värdet för variabeln $a4.

Exempel	Modus	Resultat
2	Uttryck	2 (heltal)
`2	Uttryck	"2" (kommando)
Write-Output 2	Uttryck	2 (heltal)
2+2	Uttryck	4 (heltal)
Write-Output 2+2	Argumentation	"2+2" (sträng)
Write-Output(2+2)	Uttryck	4 (heltal)
$a	Uttryck	4 (heltal)
Write-Output $a	Uttryck	4 (heltal)
$a+2	Uttryck	6 (heltal)
Write-Output $a+2	Argumentation	4+2 (sträng)
$-	Argumentation	"$-" (kommando)
Write-Output $-	Argumentation	"$-" (sträng)
a$a	Uttryck	a$a (kommando)
Write-Output a$a	Argumentation	"a4" (sträng)
a'$a'	Uttryck	a$a (kommando)
Write-Output a'$a'	Argumentation	a$a (sträng)
a"$a"	Uttryck	a$a (kommando)
Write-Output a"$a"	Argumentation	"a4" (sträng)
a$(2)	Uttryck	a$(2) (kommando)
Write-Output a$(2)	Argumentation	"a2" (sträng)

Varje token kan tolkas som någon typ av objekttyp, till exempel boolesk eller String. PowerShell försöker fastställa objekttypen från uttrycket. Objekttypen beror på vilken typ av parameter ett kommando förväntar sig och om PowerShell vet hur argumentet ska konverteras till rätt typ. I följande tabell visas flera exempel på de typer som tilldelats värden som returneras av uttrycken.

Exempel	Modus	Resultat
Write-Output !1	argument	"!1" (sträng)
Write-Output (!1)	uttryck	Falskt (booleskt)
Write-Output (2)	uttryck	2 (heltal)
Set-Variable AB A,B	argument	'A','B' (matris)
CMD /CECHO A,B	argument	'A,B' (sträng)
CMD /CECHO $AB	uttryck	"A B" (matris)
CMD /CECHO :$AB	argument	':A B' (sträng)

Skicka argument till inbyggda kommandon

När du kör interna kommandon från PowerShell parsas argumenten först av PowerShell. De parsade argumenten kopplas sedan till en enda sträng med varje parameter avgränsad med ett blanksteg.

Följande kommando anropar till exempel icacls.exe-programmet.

icacls X:\VMS /grant Dom\HVAdmin:(CI)(OI)F

Om du vill köra det här kommandot i PowerShell 2.0 måste du använda escape-tecken för att förhindra att PowerShell feltolkar parenteserna.

icacls X:\VMS /grant Dom\HVAdmin:`(CI`)`(OI`)F

Stopptoken för parsing

Från och med PowerShell 3.0 kan du använda token stop-parsing (--%) för att hindra PowerShell från att tolka indata som PowerShell-kommandon eller -uttryck.

Anmärkning

Token för stoppparsning är endast avsedd att användas på Windows-plattformar.

När du anropar ett internt kommando placerar du stop-parsing-token före programargumenten. Den här tekniken är mycket enklare än att använda escape-tecken för att förhindra feltolkning.

När den stöter på en stop-parsing-token behandlar PowerShell de återstående tecknen på raden som en literal. Den enda tolkning som utförs är att ersätta värden för miljövariabler som använder Standard Windows-notation, till exempel %USERPROFILE%.

icacls X:\VMS --% /grant Dom\HVAdmin:(CI)(OI)F

PowerShell skickar följande kommandosträng till icacls.exe-programmet:

X:\VMS /grant Dom\HVAdmin:(CI)(OI)F

Token för stoppparsning gäller endast fram till nästa nya rad- eller pipelinetecken. Du kan inte använda ett fortsättningstecken (`) för att utöka dess effekt eller använda en kommandoavgränsare (;) för att avsluta dess effekt.

%variable% Förutom miljövariabelreferenser kan du inte bädda in några andra dynamiska element i kommandot. Det går inte att undvika ett % tecken som , på det sätt som %%du kan göra i batchfiler. %<name>% tokens expanderas alltid. Om <name> det inte refererar till en definierad miljövariabel skickas token via as-is.

Du kan inte använda omdirigering av dataströmmar (t.ex >file.txt. ) eftersom de skickas ordagrant som argument till målkommandot.

Skicka argument som innehåller citattecken

Vissa interna kommandon förväntar sig argument som innehåller citattecken. Normalt tar PowerShells kommandoradsparsing bort citattecknet som du angav. De parsade argumenten kopplas sedan till en enda sträng med varje parameter avgränsad med ett blanksteg. Den här strängen tilldelas sedan egenskapen Argument för ett ProcessStartInfo objekt. Citattecken i strängen måste vara undantagna med hjälp av extra citattecken eller omvänt snedstreck (\) tecken.

Anmärkning

Det omvända snedstrecket (\) känns inte igen som ett escape-tecken av PowerShell. Det är escape-tecknet som används av det underliggande API:et för ProcessStartInfo.Arguments.

Mer information om escape-kraven finns i dokumentationen för ProcessStartInfo.Arguments.

Följande exempel med hjälp av TestExe.exe verktyget. Det här verktyget används av Pester-testerna på PowerShell-källlagringsplatsen. Målet med de här exemplen är att skicka katalogsökvägen "C:\Program Files (x86)\Microsoft\" till ett internt kommando så att sökvägen tas emot som en citerad sträng.

Parametern för visar de värden som tas emot som argument till den körbara filen. Du kan använda det här verktyget för att kontrollera att du har undantagit tecknen i argumenten korrekt.

TestExe -echoargs """""${env:ProgramFiles(x86)}\Microsoft\\"""""
TestExe -echoargs """""C:\Program Files (x86)\Microsoft\\"""""
TestExe -echoargs "\""C:\Program Files (x86)\Microsoft\\"""
TestExe -echoargs --% "\"C:\Program Files (x86)\Microsoft\\"
TestExe -echoargs --% """C:\Program Files (x86)\Microsoft\\""
TestExe -echoargs --% """%ProgramFiles(x86)%\Microsoft\\""

Utdata är desamma för alla exempel:

Arg 0 is <"C:\Program Files (x86)\Microsoft\">

Du kan skapa TestExe från källkoden. Mer information finns i TestExe.

Skicka argument till PowerShell-kommandon

Från och med PowerShell 3.0 kan du använda slutparametrar token (--) för att hindra PowerShell från att tolka indata som PowerShell-parametrar. Detta är en konvention som anges i POSIX Shell- och Utilities-specifikationen.

Token för slutparametrar (--) anger att alla argument som följer den ska skickas i deras faktiska form som om dubbla citattecken placerades runt dem. Om du till exempel använder -- kan du mata ut strängen -InputObject utan att använda citattecken eller tolka den som en parameter:

Write-Output -- -InputObject

-InputObject

Till skillnad från token för stop-parsning (--%) kan alla värden som följer -- token tolkas som uttryck av PowerShell.

Write-Output -- -InputObject $env:PROCESSOR_ARCHITECTURE

-InputObject
AMD64

Det här beteendet gäller endast för PowerShell-kommandon. Om du använder -- token när du anropar ett externt kommando skickas -- strängen som ett argument till kommandot.

TestExe -echoargs -a -b -- -c

Utdata visar att -- skickas som ett argument till TestExe.

Arg 0 is <-a>
Arg 1 is <-b>
Arg 2 is <-->
Arg 3 is <-c>

Se även

• om_kommandosyntax