Write-Verbose

Schreibt Text in den Stream für ausführliche Meldungen.

Syntax

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

Beschreibung

Das Write-Verbose Cmdlet 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 allgemeinen Parameter verbose 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 Write-Verbose Cmdlet, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Meldung nicht angezeigt.

Der zweite Befehl verwendet den allgemeinen Parameter Verbose , der ausführliche Nachrichten 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 Write-Verbose Cmdlet, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Meldung nicht angezeigt.

Der erste Befehl weist dem Einstellungsvariablen den Wert "Weiter" zu $VerbosePreference . Der Standardwert , SilentlyContinueunterdrückt ausführliche Nachrichten. Der zweite Befehl schreibt eine ausführliche Meldung.

Parameter

-Message

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

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

Eingaben

String

Sie können eine Zeichenfolge senden, die die Nachricht Write-Verboseenthält.

Ausgaben

None

Write-Verbose schreibt nur in den ausführlichen Nachrichtendatenstrom.

Hinweise

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