Écrit le texte dans le flux de messages commentés.
Syntaxe
Write-Verbose [-Message] <string> [<CommonParameters>]
Description
L'applet de commande Write-Verbose écrit le texte dans le flux de messages commentés de Windows PowerShell. En général, le flux de messages commentés est utilisé pour remettre des informations relatives au traitement des commandes utilisées pour le débogage d'une commande.
Par défaut, le flux de messages commentés n'est pas visible, mais vous pouvez l'afficher en modifiant la valeur de la variable $VerbosePreference ou en utilisant le paramètre courant Verbose dans n'importe quelle commande.
Paramètres
-Message <string>
Spécifie le message à afficher. Ce paramètre est obligatoire. Vous pouvez également diriger une chaîne de message vers Verbose-Message.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.String Vous pouvez diriger une chaîne contenant le message vers Write-Verbose. |
|
Sorties |
Aucun Write-Verbose écrit uniquement dans le flux de messages commentés. |
Exemple 1
C:\PS>Write-Verbose -message "Searching the Application Event Log." C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose Description ----------- Ces commandes utilisent l'applet de commande Write-Verbose pour afficher un message d'état. Par défaut, le message ne s'affiche pas. La deuxième commande utilise le paramètre courant Verbose, qui affiche tous les messages commentés, quelle que soit la valeur de la variable $VerbosePreference.
Exemple 2
C:\PS>$VerbosePreference = "Continue" C:\PS> Write-Verbose "Copying file $filename" Description ----------- Ces commandes utilisent l'applet de commande Write-Verbose pour afficher un message d'état. Par défaut, le message ne s'affiche pas. La première commande attribue la valeur « Continue » à la variable de préférence $VerbosePreference. La valeur par défaut, « SilentlyContinue », supprime les messages commentés. La deuxième commande écrit un message commenté.
Voir aussi