Get-Error

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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 egy P Standard kiadás xtendedError objektumot kap, 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 $Erroraz 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.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Newest

Az aktuális munkamenetben előforduló megjelenítendő hibák számát adja meg.

Type:Int32
Aliases:Last
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

ErrorRecord

Ez a parancsmag egy P Standard kiadás xtendedError objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Get-Errortartalmazza:

  • Minden platform:
    • gerr

Get-Error folyamatbemenetet fogad el. Például: $Error | Get-Error.