Sdílet prostřednictvím

Get-Error

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá a zobrazí nejnovější chybové zprávy z aktuální relace.

Syntaxe

Get-Error
   [[-Newest] <Int32>]
   [<CommonParameters>]
Get-Error
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Rutina Get-Error získá objekt PSExtendedError, který představuje aktuální podrobnosti o chybě z poslední chyby, ke které došlo v relaci.

Pomocí Get-Error můžete zobrazit zadaný počet chyb, ke kterým došlo v aktuální relaci, pomocí parametru Nejnovější.

Rutina Get-Error také obdrží chybové objekty z kolekce, například $Error, k zobrazení více chyb z aktuální relace.

Příklady

Příklad 1: Získání nejnovějších podrobností o chybě

V tomto příkladu Get-Error zobrazí podrobnosti o nejnovější chybě, ke které došlo v aktuální relaci.

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 :

Příklad 2: Získání zadaného počtu chybových zpráv, ke kterým došlo v aktuální relaci

Tento příklad ukazuje, jak používat Get-Error s parametrem Nejnovější. V tomto příkladu Nejnovější vrátí podrobnosti o 3 nejnovějších chybách, ke kterým došlo v této relaci.

Get-Error -Newest 3

Příklad 3: Odeslání kolekce chyb pro příjem podrobných zpráv

$Error automatická proměnná obsahuje pole chybových objektů v aktuální relaci. Pole objektů lze předvést do Get-Error, aby se zobrazily podrobné chybové zprávy.

V tomto příkladu se $Error předá rutině Get-Error. výsledek je seznam podrobných chybových zpráv, podobně jako výsledek příkladu 1.

$Error | Get-Error

Parametry

-InputObject

Tento parametr se používá pro vstup kanálu.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Newest

Určuje počet chyb, které se mají zobrazit v aktuální relaci.

Typ:Int32
Aliasy:Last
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Do této rutiny můžete převést libovolný objekt PSObject, ale výsledky se liší, pokud není zadán objekt ErrorRecord nebo Exception.

Výstupy

ErrorRecord

Tato rutina vrátí objekt PSExtendedError.

Poznámky

PowerShell obsahuje následující aliasy pro Get-Error:

  • Všechny platformy:
    • gerr

Get-Error přijímá vstup kanálu. Například $Error | Get-Error.