Get-Error
Lekéri és megjeleníti az aktuális munkamenet legutóbbi hibaüzeneteit.
Syntax
Get-Error
[[-Newest] <Int32>]
[<CommonParameters>]
Get-Error
[-InputObject <PSObject>]
[<CommonParameters>]
Description
A Get-Error
parancsmag lekéri a PSExtendedError objektumot, amely a munkamenetben bekövetkezett legutóbbi hiba aktuális hibaadatait jeleníti meg.
A Legújabb paraméterrel megjeleníthet Get-Error
egy megadott számú hibát, amely az aktuális munkamenetben történt.
A Get-Error
parancsmag egy gyűjteményből is fogad hibaobjektumokat, például $Error
az aktuális munkamenet több hibájának megjelenítéséhez.
Példák
1. példa: A legutóbbi hiba részleteinek lekérése
Ebben a példában Get-Error
az aktuális munkamenetben előforduló legutóbbi hiba részleteit jeleníti meg.
Get-Childitem -path /NoRealDirectory
Get-Error
Get-ChildItem: Cannot find path 'C:\NoRealDirectory' because it does not exist.
Exception :
ErrorRecord :
Exception :
Message : Cannot find path 'C:\NoRealDirectory' because it does not exist.
HResult : -2146233087
TargetObject : C:\NoRealDirectory
CategoryInfo : ObjectNotFound: (C:\NoRealDirectory:String) [], ParentContainsErrorRecordException
FullyQualifiedErrorId : PathNotFound
ItemName : C:\NoRealDirectory
SessionStateCategory : Drive
TargetSite :
Name : GetChildItems
DeclaringType : System.Management.Automation.SessionStateInternal
MemberType : Method
Module : System.Management.Automation.dll
StackTrace :
at System.Management.Automation.SessionStateInternal.GetChildItems(String path, Boolean recurse, UInt32 depth,
CmdletProviderContext context)
at System.Management.Automation.ChildItemCmdletProviderIntrinsics.Get(String path, Boolean recurse, UInt32
depth, CmdletProviderContext context)
at Microsoft.PowerShell.Commands.GetChildItemCommand.ProcessRecord()
Message : Cannot find path 'C:\NoRealDirectory' because it does not exist.
Source : System.Management.Automation
HResult : -2146233087
TargetObject : C:\NoRealDirectory
CategoryInfo : ObjectNotFound: (C:\NoRealDirectory:String) [Get-ChildItem], ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.GetChildItemCommand
InvocationInfo :
MyCommand : Get-ChildItem
ScriptLineNumber : 1
OffsetInLine : 1
HistoryId : 57
Line : Get-Childitem -path c:\NoRealDirectory
PositionMessage : At line:1 char:1
+ Get-Childitem -path c:\NoRealDirectory
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
InvocationName : Get-Childitem
CommandOrigin : Internal
ScriptStackTrace : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo :
2. példa: Az aktuális munkamenetben előforduló hibaüzenetek megadott számának lekérése
Ez a példa bemutatja, hogyan használható Get-Error
a Legújabb paraméterrel. Ebben a példában a Legújabb az ebben a munkamenetben előforduló 3 legújabb hiba részleteit adja vissza.
Get-Error -Newest 3
3. példa: Hibagyűjtemény küldése részletes üzenetek fogadásához
Az $Error
automatikus változó az aktuális munkamenetben hibaobjektumokat tartalmazó tömböt tartalmaz. Az objektumok tömbje a részletes hibaüzenetek fogadásához Get-Error
csövezhető.
Ebben a példában $Error
a parancsmagba Get-Error
van csövezve. az eredmény az 1. példa eredményéhez hasonló részletes hibaüzenetek listája.
$Error | Get-Error
Paraméterek
-InputObject
Ez a paraméter a folyamatbemenethez használatos.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Newest
Az aktuális munkamenetben előforduló megjelenítendő hibák számát adja meg.
Típus: | Int32 |
Aliasok: | Last |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
PSObject
A parancsmaghoz bármilyen PSObject csövet helyezhet, de az eredmények eltérőek lehetnek, kivéve, ha egy ErrorRecord vagy Exception objektum van megadva.
Kimenetek
Ez a parancsmag psExtendedError objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat Get-Error
tartalmazza:
- Minden platform:
gerr
Get-Error
folyamatbemenetet fogad el. Például: $Error | Get-Error
.