LLI Wiki — My Digital Knowledge Base

Analyser et relancer les erreurs PowerShell

Inspecter les erreurs PowerShell ($Error, pile d'appels) et relancer les exceptions avec contexte.

Quelques commandes et réglages utiles pour analyser une erreur PowerShell et contrôler son comportement dans un script.

Inspecter la dernière erreur

Get-PSCallStack
$Error[0].Exception.StackTrace
$Error[0].Exception.InnerException.StackTrace
$Error[0].StackTrace
$Error[0] | Format-List -Force
$Error[0] | Select-Object *

$Error est une collection qui contient les erreurs de la session ; l'erreur la plus récente est $Error[0].

Relancer une exception avec contexte

} catch {
    Write-JobStatus -Id $rowID -Status "error" -ErrorMessage $_ -Ended (Get-Date)
    throw ( New-Object System.Exception( "New Exception", $_.Exception ) )
    Throw $_.Exception
}

La ligne Throw $_.Exception placée après throw n'est jamais atteinte, car le premier throw interrompt le bloc.

Mode débogage

Affiche les messages d'information, verbeux et de débogage, et arrête le script à la première erreur.

$ErrorActionPreference = 'Stop'
$InformationPreference = 'Continue'
$VerbosePreference = 'Continue'
$DebugPreference = 'Continue'

Retour au comportement par défaut

$ErrorActionPreference = 'Continue'
$InformationPreference = 'SilentlyContinue'
$VerbosePreference = 'SilentlyContinue'
$DebugPreference = 'SilentlyContinue'

Pour un exemple d'utilisation de SMO dans un contexte proche, voir sqlserverpowershell.com.

Mastodon LLIMastodon SocialFosstodon