Write-Verbose

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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, Sie können ihn jedoch anzeigen, indem Sie den Wert der $VerbosePreference Variablen ändern oder den allgemeinen Parameter "Verbose " in einem beliebigen 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 Verbose-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 Write-Verbose Cmdlet, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Meldung nicht angezeigt.

Der erste Befehl weist der $VerbosePreference Einstellungsvariablen den Wert "Weiter" zu. 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
Required:True
Accept pipeline input:True
Accept wildcard characters: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 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 Meldung standardmäßig angezeigt wird. Weitere Informationen zur Variable $VerbosePreference finden Sie unter about_Preference_Variables.