Get-Error
Возвращает и отображает последние сообщения об ошибках из текущего сеанса.
Синтаксис
Get-Error
[[-Newest] <Int32>]
[<CommonParameters>]
Get-Error
[-InputObject <PSObject>]
[<CommonParameters>]
Описание
Командлет Get-Error
получает объект PSExtendedError , представляющий сведения о текущей ошибке из последней ошибки, которая произошла в сеансе.
Можно использовать для Get-Error
отображения указанного числа ошибок, произошедших в текущем сеансе, с помощью параметра Newest .
Командлет Get-Error
также получает объекты ошибок из коллекции, например $Error
, для отображения нескольких ошибок из текущего сеанса.
Примеры
Пример 1. Получение последних сведений об ошибке
В этом примере Get-Error
отображаются сведения о последней ошибке, которая произошла в текущем сеансе.
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 :
Пример 2. Получение указанного количества сообщений об ошибках, возникших в текущем сеансе
В этом примере показано, как использовать Get-Error
параметр Newest . В этом примере newest возвращает сведения о трех новейших ошибках, произошедших в этом сеансе.
Get-Error -Newest 3
Пример 3. Отправка коллекции ошибок для получения подробных сообщений
Автоматическая $Error
переменная содержит массив объектов ошибок в текущем сеансе. Массив объектов можно передать по конвейеру для Get-Error
получения подробных сообщений об ошибках.
В этом примере $Error
передается в Get-Error
командлет . результатом является список подробных сообщений об ошибках, аналогичных результату примера 1.
$Error | Get-Error
Параметры
-InputObject
Этот параметр используется для входных данных конвейера.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Newest
Указывает количество отображаемых ошибок, произошедших в текущем сеансе.
Type: | Int32 |
Aliases: | Last |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
PSObject
Поддерживает входные данные из любого ОБЪЕКТА PSObject, но результаты будут отличаться, если не указан объект ErrorRecord или Exception .
Выходные данные
Выходные данные в объекте PSExtendedError .
Примечания
Get-Error
принимает входные данные конвейера. Например, $Error | Get-Error
.