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.

Syntax

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

Podporuje vstup z libovolného objektu PSObject, ale výsledky se liší, pokud není zadán objekt ErrorRecord nebo Exception .

Výstupy

ErrorRecord

Výstup v objektu PSExtendedError .

Poznámky

Get-Error přijímá vstup z potrubí. Například: $Error | Get-Error.