about_Trap
Kort beskrivning
Beskriver ett nyckelord som hanterar ett avslutande fel.
Lång beskrivning
Ett avslutande fel hindrar en instruktion från att köras. Om PowerShell inte hanterar ett avslutande fel på något sätt slutar PowerShell också att köra funktionen eller skriptet i den aktuella pipelinen. På andra språk, till exempel C#, kallas avslutande fel undantag.
Nyckelordet trap
anger en lista över instruktioner som ska köras när ett avslutande fel inträffar. trap
-instruktioner kan hantera avslutande fel på följande sätt:
Visa felet efter bearbetning av instruktionsblocket
trap
och fortsatt körning av skriptet eller funktionen som innehållertrap
. Det här är standardbeteendet.Anteckning
När det avslutande felet inträffar i ett underordnat skriptblock, till exempel en
if
-instruktion ellerforeach
loop, körs -instruktionerna itrap
blocket och körningen fortsätter vid nästa -instruktion utanför det underordnade skriptblocket.Visa felet och avbryt körningen av skriptet eller funktionen som innehåller
trap
användningbreak
i -instruktionentrap
.Tysta felet, men fortsätt körningen av skriptet eller funktionen som innehåller
trap
med hjälpcontinue
av i -instruktionentrap
.
Instruktionslistan trap
för kan innehålla flera villkor eller funktionsanrop. En trap
kan skriva loggar, testa villkor eller till och med köra ett annat program.
Syntax
- trap
instruktionen har följande syntax:
trap [[<error type>]] {<statement list>}
-instruktionen trap
innehåller en lista över instruktioner som ska köras när ett avslutande fel inträffar. En trap
-instruktion består av nyckelordet trap
, eventuellt följt av ett typuttryck, och instruktionsblocket som innehåller listan över -instruktioner som ska köras när ett fel fångas. Typuttrycket förfinar de typer av fel som trap
fångas upp.
Ett skript eller kommando kan ha flera trap
instruktioner. trap
-instruktioner kan visas var som helst i skriptet eller kommandot.
Fånga alla avslutande fel
När ett avslutande fel inträffar som inte hanteras på något annat sätt i ett skript eller kommando söker PowerShell efter en trap
-instruktion som hanterar felet. Om det finns en trap
-instruktion fortsätter PowerShell att köra skriptet eller kommandot i -instruktionen trap
.
Följande exempel är en mycket enkel trap
instruktion:
trap {"Error found."}
Den här trap
instruktionen genererar traps för avslutande fel.
I följande exempel innehåller funktionen en nonsenssträng som orsakar ett körningsfel.
function TrapTest {
trap {"Error found."}
nonsenseString
}
TrapTest
Om du kör den här funktionen returneras följande:
Error found.
nonsenseString:
Line |
3 | nonsenseString
| ~~~~~~~~~~~~~~
| The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
Följande exempel innehåller en trap
-instruktion som visar felet med hjälp av den $_
automatiska variabeln:
function TrapTest {
trap {"Error found: $_"}
nonsenseString
}
TrapTest
Om du kör den här versionen av funktionen returneras följande:
Error found: The term 'nonsenseString' is not recognized as the name of a
cmdlet, function, script file, or operable program. Check the spelling of the
name, or if a path was included, verify that the path is correct and try again.
nonsenseString:
Line |
3 | nonsenseString
| ~~~~~~~~~~~~~~
| The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
Viktigt
trap
-instruktioner kan definieras var som helst inom ett visst omfång, men gäller alltid för alla instruktioner i det omfånget. Vid körning trap
definieras instruktioner i ett block innan andra instruktioner körs. I JavaScript kallas detta hissning. Det innebär att trap
-instruktioner gäller för alla -instruktioner i blocket även om körningen inte har avancerat förbi den punkt där de definieras. Om du till exempel definierar en trap
i slutet av ett skript och utlöser ett fel i den första -instruktionen utlöses fortfarande den trap
.
Fånga specifika fel
Ett skript eller kommando kan ha flera trap
instruktioner. En trap
kan definieras för att hantera specifika fel.
Följande exempel är en trap
instruktion som genererar traps för det specifika felet CommandNotFoundException:
trap [System.Management.Automation.CommandNotFoundException]
{"Command error trapped"}
När en funktion eller ett skript påträffar en sträng som inte matchar ett känt kommando, visar den här trap
instruktionen strängen "Kommandofel fångade".
När du har kört instruktionslistan trap
skriver PowerShell felobjektet till felströmmen och fortsätter sedan skriptet.
PowerShell använder .NET-undantagstyper. I följande exempel anges feltypen System.Exception :
trap [System.Exception] {"An error trapped"}
Feltypen CommandNotFoundException ärver från typen System.Exception . Den här instruktionen genererar ett fel som skapas med ett okänt kommando. Den genererar också andra feltyper.
Du kan ha fler än en trap
instruktion i ett skript. Varje feltyp kan bara fångas av en trap
-instruktion. När ett avslutande fel inträffar söker trap
PowerShell efter med den mest specifika matchningen, med början i det aktuella körningsomfånget.
Följande skriptexempel innehåller ett fel. Skriptet innehåller en allmän trap
instruktion som genererar traps för avslutande fel och en specifik trap
instruktion som anger typen CommandNotFoundException .
trap {"Other terminating error trapped" }
trap [System.Management.Automation.CommandNotFoundException] {
"Command error trapped"
}
nonsenseString
När du kör det här skriptet får du följande resultat:
Command error trapped
nonsenseString:
Line |
5 | nonsenseString
| ~~~~~~~~~~~~~~
| The term 'nonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
Eftersom PowerShell inte känner igen "nonsenseString" som en cmdlet eller något annat objekt returneras ett CommandNotFoundException-fel . Det här avslutande felet fångas av den specifika trap
-instruktionen.
Följande skriptexempel innehåller samma trap
instruktioner med ett annat fel:
trap {"Other terminating error trapped" }
trap [System.Management.Automation.CommandNotFoundException]
{"Command error trapped"}
1/$null
När du kör det här skriptet får du följande resultat:
Other terminating error trapped
RuntimeException:
Line |
4 | 1/$null
| ~~~~~~~
| Attempted to divide by zero.
Försöket att dividera med noll skapar inte ett CommandNotFoundException-fel . I stället fångas det felet av den andra trap
-instruktionen, som genererar eventuella avslutande fel.
Fånga fel i ett skriptblock
När ett avslutande fel utlöses överförs som standard körningen till trap-instruktionen. trap
När blocket har körts återgår kontrollen till nästa instruktionsblock efter platsen för felet.
När till exempel ett avslutande fel inträffar i en foreach
-instruktion körs -instruktionen trap
och körningen fortsätter vid nästa -instruktion efter foreach
blocket, inte inom foreach
blocket.
trap { 'An error occurred!'}
foreach ($x in 3..0) {
1/$x
'after division'
}
'after loop'
0.333333333333333
after division
0.5
after division
1
after division
An error occurred!
RuntimeException: untitled:Untitled-1:3:4
Line |
3 | 1/$x
| ~~~~
| Attempted to divide by zero.
after loop
I utdata ovan kan du se looparna fortsätta fram till den senaste iterationen.
När skriptet försöker dividera 1 med 0 utlöses ett avslutande fel. Resten av foreach
scriptblock hoppas över, -instruktionen try
körs och skriptet fortsätter efter scriptblock.foreach
Fånga fel och omfång
Om ett avslutande fel inträffar i samma omfång som -instruktionen trap
kör PowerShell listan med -instruktioner som definieras av trap
. Körningen fortsätter vid -instruktionen efter felet. Om -instruktionen trap
är i ett annat omfång än felet fortsätter körningen vid nästa -instruktion som finns i samma omfång som -instruktionen trap
.
Om till exempel ett fel inträffar i en funktion och -instruktionen trap
finns i funktionen fortsätter skriptet vid nästa instruktion. Följande skript innehåller ett fel och en trap
-instruktion:
function function1 {
trap { "An error: " }
NonsenseString
"function1 was completed"
}
function1
När du kör det här skriptet får du följande resultat:
An error:
NonsenseString:
Line |
3 | NonsenseString
| ~~~~~~~~~~~~~~
| The term 'NonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
function1 was completed
Instruktionen trap
i funktionen genererar traps för felet. När du har visat meddelandet fortsätter PowerShell att köra funktionen. Observera att Function1
har slutförts.
Jämför detta med följande exempel, som har samma fel och trap
instruktion. I det här exemplet sker -instruktionen trap
utanför funktionen:
function function2 {
NonsenseString
"function2 was completed"
}
trap { "An error: " }
function2
När du Function2
kör funktionen genereras följande resultat:
An error:
NonsenseString:
Line |
2 | NonsenseString
| ~~~~~~~~~~~~~~
| The term 'NonsenseString' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or
if a path was included, verify that the path is correct and try again.
I det här exemplet kördes inte kommandot "function2 was completed". I båda exemplen uppstår det avslutande felet i funktionen . I det här exemplet ligger dock -instruktionen trap
utanför funktionen. PowerShell går inte tillbaka till funktionen när -instruktionen har körts trap
.
Varning
När flera traps definieras för samma felvillkor används det första trap
lexikala (högst i omfånget).
I följande exempel körs bara trap
med "whoops 1".
Remove-Item -ErrorAction Stop ThisFileDoesNotExist
trap { "whoops 1"; continue }
trap { "whoops 2"; continue }
Viktigt
En Trap-instruktion är begränsad till den ställe där den kompileras. Om du har en trap
-instruktion i ett funktions- eller punktkällskript tas alla trap
instruktioner inuti bort när funktionen eller skriptet med punktkälla avslutas.
Använda nyckelorden break och continue
Du kan använda nyckelorden break
och continue
i en trap
-instruktion för att avgöra om ett skript eller kommando fortsätter att köras efter ett avslutande fel.
Om du inkluderar en break
instruktion i en trap
instruktionslista stoppar PowerShell funktionen eller skriptet. Följande exempelfunktion använder nyckelordet break
i en trap
-instruktion:
function break_example {
trap {
"Error trapped"
break
}
1/$null
"Function completed."
}
break_example
Error trapped
ParentContainsErrorRecordException:
Line |
6 | 1/$null
| ~~~~~~~
| Attempted to divide by zero.
Eftersom -instruktionen trap
inkluderade nyckelordet break
fortsätter inte funktionen att köras och raden "Funktionen har slutförts" körs inte.
Om du inkluderar ett continue
nyckelord i en trap
-instruktion återupptas PowerShell efter -instruktionen som orsakade felet, precis som utan break
eller continue
. Med nyckelordet continue
skriver PowerShell dock inte ett fel till felströmmen.
Följande exempelfunktion använder nyckelordet continue
i en trap
-instruktion:
function continue_example {
trap {
"Error trapped"
continue
}
1/$null
"Function completed."
}
continue_example
Error trapped
Function completed.
Funktionen återupptas när felet har fastnat och instruktionen "Funktionen har slutförts" körs. Inget fel skrivs till felströmmen.
Kommentarer
trap
-instruktioner är ett enkelt sätt att i stort sett se till att alla avslutande fel inom ett omfång hanteras. För mer detaljerad felhantering använder du try
/catch
block där traps definieras med hjälp av catch
instruktioner. - catch
instruktionerna gäller endast för koden i den associerade try
-instruktionen. Mer information finns i about_Try_Catch_Finally.