Поделиться через


Write-Verbose

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

Синтаксис

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

Описание

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

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

Примеры

Пример 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"

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

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

Параметры

-Message

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

Тип:String
Aliases:Msg
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

String

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

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

None

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

Примечания

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