Write-Verbose

Modul:
Microsoft.PowerShell.Utility Module

Schreibt Text in den ausführlichen Nachrichtendatenstrom.

Syntax

Default (Standard) 

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 Nachricht 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 Nachricht 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 Nachricht.

Parameter

-Message

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Msg

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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 Variable $VerbosePreference 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.