Schreibt Text in den Stream für ausführliche Meldungen.
Syntax
Write-Verbose [-Message] <string> [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Write-Verbose" wird Text in den Stream für ausführliche Meldungen in Windows PowerShell geschrieben. Der Stream für ausführliche Meldungen wird i. d. R. verwendet, um Informationen über die Befehlsverarbeitung bereitzustellen, die zum Debuggen eines Befehls dienen.
Standardmäßig wird der Stream für ausführliche Meldungen nicht angezeigt, Sie können ihn jedoch anzeigen, indem Sie den Wert der Variablen "$VerbosePreference" ändern oder den allgemeinen Verbose-Parameter in einem beliebigen Befehl verwenden.
Parameter
-Message <string>
Gibt die Meldung an, die angezeigt werden soll. Dieser Parameter ist erforderlich. Sie können eine Meldungszeichenfolge auch über die Pipeline an Verbose-Message übergeben.
Erforderlich? |
true |
Position? |
1 |
Standardwert |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
System.String Sie können über die Pipeline eine Zeichenfolge, die eine Meldung enthält, an Write-Verbose übergeben. |
Ausgaben |
None Write-Verbose schreibt nur in den Stream für ausführliche Meldungen. |
Beispiel 1
C:\PS>Write-Verbose -message "Searching the Application Event Log." C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose Beschreibung ----------- Mit diesen Befehlen wird das Cmdlet "Write-Verbose" verwendet, um eine Statusmeldung 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 Variablen "$VerbosePreference" anzeigt.
Beispiel 2
C:\PS>$VerbosePreference = "Continue" C:\PS> Write-Verbose "Copying file $filename" Beschreibung ----------- Mit diesen Befehlen wird das Cmdlet "Write-Verbose" verwendet, um eine Statusmeldung anzuzeigen. Standardmäßig wird die Meldung nicht angezeigt. Mit dem ersten Befehl wird der Einstellungsvariablen "$VerbosePreference" der Wert "Continue" zugewiesen. Mit dem Standardwert "SilentlyContinue" werden ausführliche Meldungen unterdrückt. Mit dem zweiten Befehl wird eine ausführliche Meldung geschrieben.
Siehe auch