Partager via

Write-Verbose

  • Référence
Module:
Microsoft.PowerShell.Utility

Écrit du texte dans le flux de message détaillé.

Syntax

Write-Verbose
     [-Message] <String>
     [<CommonParameters>]

Description

L’applet Write-Verbose de commande écrit du texte dans le flux de messages détaillés dans PowerShell. En règle générale, le flux de messages détaillés est utilisé pour fournir des informations plus détaillées sur le traitement des commandes.

Par défaut, le flux de messages détaillés n’est pas affiché, mais vous pouvez l’afficher en modifiant la valeur de la $VerbosePreference variable ou en utilisant le paramètre commun Verbose dans n’importe quelle commande.

Exemples

Exemple 1 : Écrire un message status

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

Ces commandes utilisent l’applet Write-Verbose de commande pour afficher un message status. Par défaut, le message n'est pas affiché.

La deuxième commande utilise le paramètre commun Verbose , qui affiche tous les messages détaillés, quelle que soit la valeur de la $VerbosePreference variable.

Exemple 2 : Définir $VerbosePreference et écrire un message status

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

Ces commandes utilisent l’applet Write-Verbose de commande pour afficher un message status. Par défaut, le message n'est pas affiché.

La première commande affecte la valeur Continuer à la variable de $VerbosePreference préférence. La valeur par défaut, SilentlyContinue, supprime les messages détaillés. La deuxième commande écrit un message détaillé.

Paramètres

-Message

Spécifie le message à afficher. Ce paramètre est obligatoire. Vous pouvez également diriger une chaîne de message vers Write-Verbose.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne qui contient le message vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie. Il écrit uniquement dans le flux de messages détaillés.

Notes

  • Les messages détaillés sont retournés uniquement quand la commande utilise le paramètre commun Verbose. Pour plus d’informations, consultez about_CommonParameters.
  • Dans Windows PowerShell travaux en arrière-plan et les commandes à distance, la $VerbosePreference variable dans la session de travail et la session à distance déterminent si le message détaillé est affiché par défaut. Pour plus d’informations sur la $VerbosePreference variable, consultez about_Preference_Variables.