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 Nachrichtenstrom in PowerShell. In der Regel wird der ausführlichere Nachrichtenstrom verwendet, um ausführlichere Informationen zur Befehlsverarbeitung bereitzustellen.

Standardmäßig wird der verbose Nachrichtenstrom nicht angezeigt, sie kann jedoch angezeigt werden, indem Sie den Wert der $VerbosePreference Variablen ändern oder den allgemeinen Parameter verbose in einem beliebigen Befehl verwenden.

Beispiele

Beispiel 1: Schreiben einer Statusnachricht

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 häufigen Parameter Verbose, der verbose Nachrichten anzeigt, unabhängig vom Wert der $VerbosePreference Variable.

Beispiel 2: Festlegen von $VerbosePreference und Schreiben einer Statusnachricht

$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, SilentlyContinue, unterdrückt verbose 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-Verbosesenden.

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 senden, die die Nachricht enthält Write-Verbose.

Ausgaben

None

Write-Verbose schreibt nur auf 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 Variable in der Auftragssitzung und Remotesitzung, ob die $VerbosePreference verbose Nachricht standardmäßig angezeigt wird. Weitere Informationen zu der $VerbosePreference Variablen finden Sie unter about_Preference_Variables.