Get-Error
Lekéri és megjeleníti az aktuális munkamenet legutóbbi hibaüzeneteit.
Syntax
Newest (Alapértelmezett)
Get-Error
[[-Newest] <Int32>]
[<CommonParameters>]
Error
Get-Error
[-InputObject <PSObject>]
[<CommonParameters>]
Description
A Get-Error parancsmag egy PSExtendedError objektumot kap, amely a munkamenet utolsó hibájának aktuális hibaadatait jeleníti meg.
A Get-Error használatával megjeleníthet egy megadott számú hibát, amely az aktuális munkamenetben történt az Legújabb paraméter használatával.
A Get-Error parancsmag egy gyűjteményből is fogad hibaobjektumokat, például $Error, hogy több hibát jelenítsen meg az aktuális munkamenetből.
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 bekövetkezett 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 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 található hibaobjektumok tömbét tartalmazza. Az objektumok tömbje a részletes hibaüzenetek fogadásához Get-Error csövezhető.
Ebben a példában a $Error a Get-Error parancsmagra van állítva. 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.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Error
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Newest
Az aktuális munkamenetben előforduló megjelenítendő hibák számát adja meg.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Utolsó |
Paraméterkészletek
Newest
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
A parancsmaghoz bármilyen PSObject csövezhet, de az eredmények csak akkor változnak, ha ErrorRecord vagy Exception objektum van megadva.
Kimenetek
ErrorRecord
Ez a parancsmag egy PSExtendedError objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Get-Error:
- Minden platform:
gerr
Get-Error fogadja el a folyamatbemenetet. Például: $Error | Get-Error.