Share via

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 Nachrichtenstream nicht angezeigt, aber Sie können ihn anzeigen, indem Sie den Wert der $VerbosePreference Variablen ändern oder den allgemeinen Verbose-Parameter in einem beliebigen Befehl verwenden.

Beispiele

Beispiel 1: Schreiben einer status Nachricht

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 status-Meldung anzuzeigen. Standardmäßig wird die Meldung nicht angezeigt.

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

Beispiel 2: Festlegen $VerbosePreference und Schreiben einer status Nachricht

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

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

Der erste Befehl weist der $VerbosePreference Einstellungsvariablen den Wert Continue 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 übergeben 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 übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück. Es wird nur in den ausführlichen Nachrichtendatenstrom geschrieben.

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