Delen via

Get-Error

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden de meest recente foutberichten van de huidige sessie opgehaald en weergegeven.

Syntaxis

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

Description

De cmdlet Get-Error krijgt een PSExtendedError--object dat de huidige foutdetails vertegenwoordigt van de laatste fout die in de sessie is opgetreden.

U kunt Get-Error gebruiken om een opgegeven aantal fouten weer te geven dat in de huidige sessie is opgetreden met behulp van de parameter Nieuwste.

De Get-Error cmdlet ontvangt ook foutobjecten uit een verzameling, zoals $Error, om meerdere fouten uit de huidige sessie weer te geven.

Voorbeelden

Voorbeeld 1: De meest recente foutdetails ophalen

In dit voorbeeld geeft Get-Error de details weer van de meest recente fout die is opgetreden in de huidige sessie.

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 :

Voorbeeld 2: Het opgegeven aantal foutberichten ophalen dat is opgetreden in de huidige sessie

In dit voorbeeld ziet u hoe u Get-Error gebruikt met de parameter Nieuwste. In dit voorbeeld retourneert nieuwste de details van de drie nieuwste fouten die in deze sessie zijn opgetreden.

Get-Error -Newest 3

Voorbeeld 3: Een verzameling fouten verzenden om gedetailleerde berichten te ontvangen

De $Error automatische variabele bevat een matrix met foutobjecten in de huidige sessie. De matrix met objecten kan worden doorgesluisd naar Get-Error om gedetailleerde foutberichten te ontvangen.

In dit voorbeeld wordt $Error doorgesluisd naar de cmdlet Get-Error. het resultaat is een lijst met gedetailleerde foutberichten, vergelijkbaar met het resultaat van voorbeeld 1.

$Error | Get-Error

Parameters

-InputObject

Deze parameter wordt gebruikt voor pijplijninvoer.

Type:PSObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Newest

Hiermee geeft u het aantal fouten weer te geven dat is opgetreden in de huidige sessie.

Type:Int32
Aliassen:Last
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt alle PSObject- naar deze cmdlet doorsluisen, maar de resultaten variëren, tenzij er een ErrorRecord- of Uitzonderingsobject object wordt opgegeven.

Uitvoerwaarden

ErrorRecord

Met deze cmdlet wordt een PSExtendedError--object geretourneerd.

Notities

PowerShell bevat de volgende aliassen voor Get-Error:

  • Alle platforms:
    • gerr

Get-Error accepteert pijplijninvoer. Bijvoorbeeld $Error | Get-Error.