Write-Verbose (Microsoft.PowerShell.Utility)

Write-Verbose

Модуль:: Microsoft.PowerShell.Utility

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

Синтаксис

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

Описание

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

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

Примеры

Пример 1: Напишите сообщение о состоянии

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

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

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

Пример 2. Установите $VerbosePreference и напишите сообщение о состоянии.

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

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

Параметры

-Message

Указывает сообщение для отображения. Этот параметр является обязательным. Вы также можете передать строку сообщения в Write-Verbose.

Тип :: String
Псевдонимы:: Msg
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

Входы

Строка

Вы можете передать этому командлету строку, содержащую сообщение.

Выходы

Нет

Этот командлет не возвращает никаких результатов. Он пишет только в подробный поток сообщений.

Примечания

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