Freigeben über

Get-Error

Modul:
Microsoft.PowerShell.Utility Module

Ruft die neuesten Fehlermeldungen aus der aktuellen Sitzung ab und zeigt sie an.

Syntax

Newest (Standardwert) 

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

Error 

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

Beschreibung

Das cmdlet Get-Error ruft ein PSExtendedError-Objekt ab, das die aktuellen Fehlerdetails aus dem letzten Fehler darstellt, der in der Sitzung aufgetreten ist.

Sie können Get-Error verwenden, um eine bestimmte Anzahl von Fehlern anzuzeigen, die in der aktuellen Sitzung aufgetreten sind, indem Sie den Parameter Neueste verwenden.

Das Cmdlet Get-Error empfängt auch Fehlerobjekte aus einer Auflistung, z. B. $Error, um mehrere Fehler aus der aktuellen Sitzung anzuzeigen.

Beispiele

Beispiel 1: Abrufen der neuesten Fehlerdetails

In diesem Beispiel zeigt Get-Error die Details des letzten Fehlers an, der in der aktuellen Sitzung aufgetreten ist.

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 :

Beispiel 2: Abrufen der angegebenen Anzahl von Fehlermeldungen, die in der aktuellen Sitzung aufgetreten sind

In diesem Beispiel wird gezeigt, wie Sie Get-Error mit dem Parameter Newest verwenden. In diesem Beispiel gibt Neueste die Details der drei neuesten Fehler zurück, die in dieser Sitzung aufgetreten sind.

Get-Error -Newest 3

Beispiel 3: Senden einer Sammlung von Fehlern zum Empfangen detaillierter Nachrichten

Die $Error automatische Variable enthält ein Array von Fehlerobjekten in der aktuellen Sitzung. Das Array von Objekten kann an Get-Error weitergeleitet werden, um detaillierte Fehlermeldungen zu erhalten.

In diesem Beispiel wird $Error an das Cmdlet Get-Error weitergeleitet. Das Ergebnis ist eine Liste detaillierter Fehlermeldungen, ähnlich dem Ergebnis von Beispiel 1.

$Error | Get-Error

Parameter

-InputObject

Dieser Parameter wird für die Pipelineeingabe verwendet.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Error
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Newest

Gibt die Anzahl der Fehler an, die in der aktuellen Sitzung angezeigt werden sollen.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Letzte

Parametersätze

Newest
Position:0
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSObject

Sie können jedes PSObject- an dieses Cmdlet weiterleiten, aber die Ergebnisse variieren, es sei denn, es wird ein ErrorRecord- oder Exception-Objekt bereitgestellt.

Ausgaben

ErrorRecord

Dieses Cmdlet gibt ein PSExtendedError--Objekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Get-Error:

  • Alle Plattformen:
    • gerr

Get-Error akzeptiert Pipelineeingaben. Beispiel: $Error | Get-Error.