Записывает текст в поток подробных сообщений.

Синтаксис

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

Описание

Командлет Write-Verbose записывает текст в поток подробных сообщений Windows PowerShell. Обычно поток подробных сообщений используется для передачи сведений об обработке команд при отладке этих команд.

По умолчанию поток подробных сообщений не отображается, однако его можно отобразить, изменив значение переменной $VerbosePreference или с помощью общего параметра Verbose любой из команд.

Параметры

-Message <string>

Задает отображаемое сообщение. Это обязательный параметр. Кроме того, строку сообщения можно передать командлету Verbose-Message по конвейеру.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue)

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.String

Строку, содержащую сообщение, можно передать командлету Write-Verbose по конвейеру.

Выходные данные

Нет

Командлет Write-Verbose осуществляет запись только в поток подробных сообщений.

Пример 1

C:\PS>Write-Verbose -message "Searching the Application Event Log."

C:\PS> Write-Verbose -message "Searching the Application Event Log." -verbose

Описание
-----------
Эти команды используют для отображения сообщения состояния командлет Write-Verbose. По умолчанию сообщение не отображается.

Вторая команда использует общий параметр Verbose, который отображает подробные сообщения независимо от значения переменной $VerbosePreference.






Пример 2

C:\PS>$VerbosePreference = "Continue"

C:\PS> Write-Verbose "Copying file $filename"

Описание
-----------
Эти команды используют для отображения сообщения состояния командлет Write-Verbose. По умолчанию сообщение не отображается.

Первая команда присваивает переменной $VerbosePreference preference значение "Continue". Значение по умолчанию ("SilentlyContinue") подавляет подробные сообщения.

Вторая команда записывает подробное сообщение.






См. также