Get-Error

Module:
Microsoft.PowerShell.Utility Module

Obtient et affiche les messages d’erreur les plus récents de la session active.

Syntaxe

Newest (Par défaut) 

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

Error 

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

Description

L’applet de commande Get-Error obtient un objet PSExtendedError qui représente les détails d’erreur actuels de la dernière erreur qui s’est produite dans la session.

Vous pouvez utiliser Get-Error pour afficher un nombre spécifié d’erreurs qui se sont produites dans la session active à l’aide du paramètre le plus récent.

L’applet de commande Get-Error reçoit également des objets d’erreur d’une collection, tels que $Error, pour afficher plusieurs erreurs de la session active.

Exemples

Exemple 1 : Obtenir les détails d’erreur les plus récents

Dans cet exemple, Get-Error affiche les détails de l’erreur la plus récente qui s’est produite dans la session active.

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 :

Exemple 2 : Obtenir le nombre spécifié de messages d’erreur qui se sont produits dans la session active

Cet exemple montre comment utiliser Get-Error avec le paramètre le plus récent. Dans cet exemple, nouveau retourne les détails des 3 erreurs les plus récentes qui se sont produites dans cette session.

Get-Error -Newest 3

Exemple 3 : Envoyer une collection d’erreurs pour recevoir des messages détaillés

La variable automatique $Error contient un tableau d’objets d’erreur dans la session active. Le tableau d’objets peut être redirigé vers Get-Error pour recevoir des messages d’erreur détaillés.

Dans cet exemple, $Error est redirigé vers l’applet de commande Get-Error. le résultat est la liste des messages d’erreur détaillés, similaires au résultat de l’exemple 1.

$Error | Get-Error

Paramètres

-InputObject

Ce paramètre est utilisé pour l’entrée de pipeline.

Propriétés du paramètre

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Error
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Newest

Spécifie le nombre d’erreurs à afficher qui se sont produites dans la session active.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Dernier

Jeux de paramètres

Newest
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSObject

Prend en charge l’entrée à partir de n’importe quel PSObject, mais les résultats varient à moins qu’un objet ErrorRecord ou Exception ne soit fourni.

Sorties

ErrorRecord

Sortie dans un objet PSExtendedError .

Notes

Get-Error accepte l’entrée de pipeline. Par exemple : $Error | Get-Error.