Udostępnij przez

Get-Error

Moduł:
Microsoft.PowerShell.Utility Module

Pobiera i wyświetla najnowsze komunikaty o błędach z bieżącej sesji.

Składnia

Newest (domyślnie) 

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

Error 

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

Opis

Polecenie cmdlet Get-Error pobiera obiekt PSExtendedError, który reprezentuje bieżące szczegóły błędu z ostatniego błędu, który wystąpił w sesji.

Można użyć Get-Error, aby wyświetlić określoną liczbę błędów, które wystąpiły w bieżącej sesji przy użyciu parametru Najnowsze.

Polecenie cmdlet Get-Error odbiera również obiekty błędów z kolekcji, takie jak $Error, w celu wyświetlenia wielu błędów z bieżącej sesji.

Przykłady

Przykład 1. Pobieranie najnowszych szczegółów błędu

W tym przykładzie Get-Error wyświetla szczegóły ostatniego błędu, który wystąpił w bieżącej sesji.

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 :

Przykład 2. Pobieranie określonej liczby komunikatów o błędach, które wystąpiły w bieżącej sesji

W tym przykładzie pokazano, jak używać Get-Error z parametrem Najnowszy. W tym przykładzie Najnowszy zwraca szczegóły 3 najnowszych błędów, które wystąpiły w tej sesji.

Get-Error -Newest 3

Przykład 3. Wysyłanie kolekcji błędów w celu odbierania szczegółowych komunikatów

Zmienna automatyczna $Error zawiera tablicę obiektów błędów w bieżącej sesji. Tablica obiektów może być potokowana do Get-Error w celu odbierania szczegółowych komunikatów o błędach.

W tym przykładzie $Error jest potokowy do polecenia cmdlet Get-Error. wynikiem są szczegółowe komunikaty o błędach podobne do wyniku przykładu 1.

$Error | Get-Error

Parametry

-InputObject

Ten parametr jest używany dla danych wejściowych potoku.

Właściwości parametru

Typ:PSObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Error
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Newest

Określa liczbę błędów do wyświetlenia, które wystąpiły w bieżącej sesji.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ostatni

Zestawy parametrów

Newest
Position:0
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

PSObject

Obsługuje dane wejściowe z dowolnego obiektu PSObject, ale wyniki różnią się, chyba że podano obiekt ErrorRecord lub Exception .

Dane wyjściowe

ErrorRecord

Dane wyjściowe w obiekcie PSExtendedError .

Uwagi

Get-Error akceptuje dane wejściowe potoku. Na przykład $Error | Get-Error.