wikinotes

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{tag>dev powershell verbose}}


====== Powershell : Utiliser l'option Verbose ======

L'option **-Verbose** fait parti des paramètres courants ([[https://learn.microsoft.com/fr-fr/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-5.1|Common parameters]]) disponibles pour les cmdlets ou les fonctions.

Les messages émis en mode verbeux utilisent un canal (buffer) dédié. Ces messages ne sont pas affiché par défaut dans la console de l'utilisateur. C'est la variable **$VerbosePreference** qui permet de déterminer le comportement pour l'environnement actif:

Les différentes valeurs possibles pour la variable **$VerbosePreference** correspondent à un sous ensemble des valeurs du type énuméré **ActionPreference**:

^ Stop              | Affiche le message et interrompt l'exécution.                                     |
^ Inquire           | Affiche le message et demande à l'utilisateur s'il souhaite continuer l'exécution |
^ Continue          | Affiche le message et continue l'exécution.                                       |
^ SilentlyContinue  | Le message n'est pas affiché, l'exécution continue (valeur par défaut).           |

<code powershell>
# Affiche le comportement par défaut pour l'environnement courant
Get-Variable -Name VerbosePreference

Name                           Value
----                           -----
VerbosePreference              SilentlyContinue

# L'environnement courant n'affiche pas les messages du canal verbeux et continue l'exécution des commandes.
# Utiliser le paramètre -Verbose permet de redéfinir le comportement pour la commande
Import-Module -Verbose .\Phobos.Epsilon.FileHashTools.psd1

COMMENTAIRES : Chargement du module à partir du chemin « D:\dev\filehash\Phobos.Epsilon.FileHashTools.psd1 ».
COMMENTAIRES : Chargement du module à partir du chemin « D:\dev\filehash\FileHashTools.psm1 ».
COMMENTAIRES : Importation de la fonction « New-FileHash ».
COMMENTAIRES : Importation de la fonction « Test-FileHash ».

# Pour que les messages verbeux soient affichés pour toutes les commandes le supportant sans avoir redéfinir
# paramètre -Verbose on peut modifier la valeur de la variable VerbosePreference
$VerbosePreference = "Continue"

Write-Verbose -Message "Ce message s'affiche maintenant dans la console"
COMMENTAIRES : Ce message s'affiche maintenant dans la console
</code>



===== Références =====

  * [[https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_preference_variables?view=powershell-7.3|A propos des variables de préférence (Microsoft Learn)]]
  *
wikinotes

Outils pour utilisateurs

Outils du site

Outils de la page
