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 cmdlet Write-Verbose 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ść zmiennej $VerbosePreference lub używając Pełne 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ą polecenia cmdlet Write-Verbose do wyświetlenia komunikatu 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

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

Te polecenia używają polecenia cmdlet Write-Verbose do wyświetlenia komunikatu 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 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 potokować ciąg zawierający komunikat, aby Write-Verbose.

Dane wyjściowe

None

Write-Verbose zapisuje tylko do pełnego strumienia komunikatów.

Uwagi

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