Udostępnij za pośrednictwem

Write-Verbose

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

Zapisuje tekst do pełnego strumienia komunikatów.

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ść zmiennej $VerbosePreference 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.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

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

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych. Zapisuje tylko do pełnego strumienia komunikatów.

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 Windows PowerShell zadania w tle i polecenia zdalne 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.