Compartir a través de

Get-Error

Módulo:
Microsoft.PowerShell.Utility Module

Obtiene y muestra los mensajes de error más recientes de la sesión actual.

Sintaxis

Newest (Es el valor predeterminado). 

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

Error 

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

Description

El cmdlet Get-Error obtiene un objeto PSExtendedError que representa los detalles de error actuales del último error que se produjo en la sesión.

Puede usar Get-Error para mostrar un número especificado de errores que se han producido en la sesión actual mediante el parámetro Newest.

El cmdlet Get-Error también recibe objetos de error de una colección, como $Error, para mostrar varios errores de la sesión actual.

Ejemplos

Ejemplo 1: Obtención de los detalles de error más recientes

En este ejemplo, Get-Error muestra los detalles del error más reciente que se produjo en la sesión actual.

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 :

Ejemplo 2: Obtener el número especificado de mensajes de error que se produjeron en la sesión actual

En este ejemplo se muestra cómo usar Get-Error con el parámetro Newest. En este ejemplo, Más reciente devuelve los detalles de los 3 errores más recientes que se produjeron en esta sesión.

Get-Error -Newest 3

Ejemplo 3: Envío de una colección de errores para recibir mensajes detallados

La variable automática $Error contiene una matriz de objetos de error en la sesión actual. La matriz de objetos se puede canalizar a Get-Error para recibir mensajes de error detallados.

En este ejemplo, $Error se canaliza al cmdlet Get-Error. el resultado es una lista de mensajes de error detallados, similar al resultado del ejemplo 1.

$Error | Get-Error

Parámetros

-InputObject

Este parámetro se usa para la entrada de tubería.

Propiedades del parámetro

Tipo:PSObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Error
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Newest

Especifica el número de errores que se van a mostrar que se han producido en la sesión actual.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Último

Conjuntos de parámetros

Newest
Posición:0
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSObject

Puede canalizar cualquier PSObject a este cmdlet, pero los resultados varían a menos que se proporcione un objeto ErrorRecord o Exception.

Salidas

ErrorRecord

Este cmdlet devuelve un objeto PSExtendedError.

Notas

PowerShell incluye los siguientes alias para Get-Error:

  • Todas las plataformas:
    • gerr

Get-Error acepta la entrada de canalización. Por ejemplo: $Error | Get-Error.