Freigeben über

Write-Verbose

Modul:
Microsoft.PowerShell.Utility Module

Schreibt Text in den ausführlichen Nachrichtendatenstrom.

Syntax

Default (Standardwert) 

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.

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