Dela via

Get-Error

Modul:
Microsoft.PowerShell.Utility Module

Hämtar och visar de senaste felmeddelandena från den aktuella sessionen.

Syntax

Newest (Standard) 

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

Error 

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

Description

Cmdleten Get-Error hämtar ett PSExtendedError--objekt som representerar den aktuella felinformationen från det senaste felet som inträffade i sessionen.

Du kan använda Get-Error för att visa ett angivet antal fel som har inträffat i den aktuella sessionen med parametern Senaste.

Cmdleten Get-Error tar också emot felobjekt från en samling, till exempel $Error, för att visa flera fel från den aktuella sessionen.

Exempel

Exempel 1: Hämta den senaste felinformationen

I det här exemplet visar Get-Error information om det senaste felet som inträffade i den aktuella sessionen.

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 :

Exempel 2: Hämta det angivna antalet felmeddelanden som inträffade i den aktuella sessionen

Det här exemplet visar hur du använder Get-Error med parametern Senaste. I det här exemplet returnerar Senaste information om de tre senaste felen som inträffade i den här sessionen.

Get-Error -Newest 3

Exempel 3: Skicka en samling fel för att ta emot detaljerade meddelanden

Den $Error automatiska variabeln innehåller en matris med felobjekt i den aktuella sessionen. Matrisen med objekt kan skickas till Get-Error för att få detaljerade felmeddelanden.

I det här exemplet skickas $Error till cmdleten Get-Error. resultatet är en lista över detaljerade felmeddelanden, ungefär som resultatet av exempel 1.

$Error | Get-Error

Parametrar

-InputObject

Den här parametern används för pipelineindata.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Error
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Newest

Anger antalet fel som ska visas under den aktuella sessionen.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Sist

Parameteruppsättningar

Newest
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSObject

Du kan skicka alla PSObject- till den här cmdleten, men resultatet varierar om inte antingen ett ErrorRecord-- eller undantagsobjekt har angetts.

Utdata

ErrorRecord

Den här cmdleten returnerar ett PSExtendedError- objekt.

Kommentarer

PowerShell innehåller följande alias för Get-Error:

  • Alla plattformar:
    • gerr

Get-Error accepterar pipelineindata. Till exempel $Error | Get-Error.