Freigeben über

Write-Verbose

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Schreibt Text in den ausführlichen Nachrichtendatenstrom.

Syntax

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

Beschreibung

Das cmdlet Write-Verbose schreibt Text in den ausführlichen Nachrichtenstream in PowerShell. In der Regel wird der ausführliche Nachrichtendatenstrom verwendet, um ausführlichere Informationen zur Befehlsverarbeitung bereitzustellen.

Standardmäßig wird der ausführliche Nachrichtendatenstrom nicht angezeigt, aber Sie können ihn anzeigen, indem Sie den Wert der $VerbosePreference Variablen ändern oder den Verbose allgemeinen Parameter in jedem Befehl verwenden.

Beispiele

Beispiel 1: Schreiben einer Statusmeldung

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

Diese Befehle verwenden das Cmdlet Write-Verbose, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Nachricht nicht angezeigt.

Der zweite Befehl verwendet den Verbose allgemeinen Parameter, der ausführliche Meldungen anzeigt, unabhängig vom Wert der $VerbosePreference Variablen.

Beispiel 2: Festlegen $VerbosePreference und Schreiben einer Statusmeldung

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

Diese Befehle verwenden das Cmdlet Write-Verbose, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Nachricht nicht angezeigt.

Der erste Befehl weist der Einstellungsvariablen $VerbosePreference den Wert "Weiter" zu. Der Standardwert, SilentlyContinue, unterdrückt ausführliche Nachrichten. Der zweite Befehl schreibt eine ausführliche Nachricht.

Parameter

-Message

Gibt die anzuzeigende Nachricht an. Dieser Parameter ist erforderlich. Sie können auch eine Nachrichtenzeichenfolge an Write-Verboseübergeben.

Typ:String
Aliase:Msg
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge, die die Nachricht enthält, an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Er schreibt nur in den ausführlichen Nachrichtendatenstrom.

Hinweise

  • Ausführliche Nachrichten werden nur zurückgegeben, wenn der Befehl den allgemeinen Parameter Verbose verwendet. Weitere Informationen finden Sie unter about_CommonParameters.
  • In Windows PowerShell-Hintergrundaufträgen und Remotebefehlen bestimmen die $VerbosePreference Variable in der Auftragssitzung und Remotesitzung, ob die ausführliche Meldung standardmäßig angezeigt wird. Weitere Informationen zur $VerbosePreference Variablen finden Sie unter about_Preference_Variables.