Write-Verbose

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

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

Синтаксис

Default (по умолчанию)

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. Значение по умолчанию, SilentlyContinue, подавляет подробные сообщения. Вторая команда записывает подробное сообщение.

Параметры

-Message

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Msg

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

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

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

None

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

Примечания

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