Write-Verbose

Module:: Microsoft.PowerShell.Utility Module

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

Syntaxe

Default (Par défaut)

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

Description

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

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

Exemples

Exemple 1 : Écrire un message d’état

PS C:\> Write-Verbose -Message "Searching the Application Event Log."
PS C:\> Write-Verbose -Message "Searching the Application Event Log." -Verbose

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

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

Exemple 2 : Définir $VerbosePreference et écrire un message d’état

PS C:\> $VerbosePreference = "Continue"
PS C:\> Write-Verbose "Copying file $filename"

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

La première commande affecte une valeur de Continuer à la variable de préférence $VerbosePreference. 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 en écriture détaillée.

Propriétés du paramètre

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

Jeux de paramètres

(All)

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
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

String

Vous pouvez diriger une chaîne qui contient le message pour écriture détaillée.

Sorties

None

écriture détaillée écrit uniquement dans le flux de messages détaillé.

Notes

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

Partager via