Sdílet prostřednictvím

Get-Error

Modul:
Microsoft.PowerShell.Utility Module

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

Syntaxe

Newest (Výchozí) 

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

Error 

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

Description

Rutina Get-Error získá objekt PSExtendedError, který reprezentuje podrobnosti poslední chyby, ke které došlo v rámci relace.

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

Cmdlet Get-Error také přijímá chybové objekty z kolekce, například $Error, aby umožnil 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 zobrazuje 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 nejnovějším parametrem . 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

Automatická proměnná $Error 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 potrubní vstup.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Error
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Newest

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

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Poslední

Sady parametrů

Newest
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSObject

Do této rutiny můžete předat jakýkoli objekt PSObject, ale výsledky se liší, ledaže je poskytnut 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 z potrubí. Například: $Error | Get-Error.