Write-Verbose

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
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

Ciąg zawierający komunikat można przekazać potokiem do 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ł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.