Write-Verbose
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-Verbose
senden.
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
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.