Write-Verbose
Zapisuje tekst w strumieniu pełnej wiadomości.
Składnia
Default (domyślnie)
Write-Verbose
[-Message] <String>
[<CommonParameters>]
Opis
Polecenie cmdlet Write-Verbose zapisuje tekst do pełnego strumienia komunikatów w programie Windows PowerShell. Zazwyczaj pełny strumień komunikatów służy do dostarczania informacji o przetwarzaniu poleceń używanych do debugowania polecenia.
Domyślnie pełny strumień komunikatów nie jest wyświetlany, ale można go wyświetlić, zmieniając wartość zmiennej $VerbosePreference lub używając Pełne wspólnego parametru w dowolnym poleceniu.
Przykłady
Przykład 1. Pisanie komunikatu o stanie
PS C:\> Write-Verbose -Message "Searching the Application Event Log."
PS C:\> Write-Verbose -Message "Searching the Application Event Log." -Verbose
Te polecenia używają polecenia cmdlet Write-Verbose, aby wyświetlić komunikat o stanie. Domyślnie komunikat nie jest wyświetlany.
Drugie polecenie używa Verbose wspólnego parametru, który wyświetla wszystkie pełne komunikaty, niezależnie od wartości zmiennej $VerbosePreference.
Przykład 2. Ustawianie $VerbosePreference i zapisywanie komunikatu o stanie
PS C:\> $VerbosePreference = "Continue"
PS C:\> Write-Verbose "Copying file $filename"
Te polecenia używają polecenia cmdlet Write-Verbose, aby wyświetlić komunikat o stanie. Domyślnie komunikat nie jest wyświetlany.
Pierwsze polecenie przypisuje wartość Kontynuuj do zmiennej preferencji $VerbosePreference. Wartość domyślna SilentlyContinue pomija pełne komunikaty. Drugie polecenie zapisuje szczegółowy komunikat.
Parametry
-Message
Określa komunikat do wyświetlenia. Ten parametr jest wymagany. Możesz również przekazać ciąg komunikatu do Write-Verbose.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Msg |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
String
Możesz potokować ciąg zawierający komunikat, aby Write-Verbose.
Dane wyjściowe
None
write-verbose zapisuje tylko do pełnego strumienia komunikatów.
Uwagi
- Komunikaty Verbose są zwracane tylko wtedy, gdy polecenie używa wspólnego parametru Verbose. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
- W zadaniach w tle programu Windows PowerShell i poleceniach zdalnych zmienna $VerbosePreference w sesji zadania i sesji zdalnej określ, czy pełny komunikat jest wyświetlany domyślnie. Aby uzyskać więcej informacji na temat zmiennej $VerbosePreference, zobacz about_Preference_Variables.