Udostępnij za pośrednictwem

Write-Verbose

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Zapisuje tekst w strumieniu pełnej wiadomości.

Składnia

Write-Verbose
     [-Message] <String>
     [<CommonParameters>]

Opis

Polecenie Write-Verbose cmdlet zapisuje tekst do pełnego strumienia komunikatów w programie PowerShell. Zazwyczaj pełny strumień komunikatów służy do dostarczania bardziej szczegółowych informacji na temat przetwarzania poleceń.

Domyślnie pełny strumień komunikatów nie jest wyświetlany, ale można go wyświetlić, zmieniając wartość $VerbosePreference zmiennej lub używając pełnego wspólnego parametru w dowolnym poleceniu.

Przykłady

Przykład 1. Pisanie komunikatu o stanie

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

Te polecenia używają Write-Verbose polecenia cmdlet do wyświetlania komunikatu o stanie. Domyślnie komunikat nie jest wyświetlany.

Drugie polecenie używa wspólnego parametru Verbose , 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

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

Te polecenia używają Write-Verbose polecenia cmdlet do wyświetlania komunikatu o stanie. Domyślnie komunikat nie jest wyświetlany.

Pierwsze polecenie przypisuje wartość Kontynuuj do zmiennej $VerbosePreference preferencji. Wartość domyślna , SilentlyContinuepomija pełne komunikaty. Drugie polecenie zapisuje pełny komunikat.

Parametry

-Message

Określa komunikat do wyświetlenia. Ten parametr jest wymagany. Możesz również przekazać ciąg komunikatu do Write-Verbose.

Typ:String
Aliasy:Msg
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przekazać ciąg zawierający komunikat do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych. Zapisuje tylko w strumieniu komunikatów pełnych.

Uwagi

  • Pełne komunikaty są zwracane tylko wtedy, gdy polecenie używa pełnego wspólnego parametru. 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śla, czy pełny komunikat jest wyświetlany domyślnie. Aby uzyskać więcej informacji na temat zmiennej $VerbosePreference , zobacz about_Preference_Variables.