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
сообщения в .
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
Можно передать строку, содержащую сообщение этому командлету.
Выходные данные
None
Этот командлет не возвращает выходные данные. Он записывает только в подробный поток сообщений.
Примечания
- Подробные сообщения возвращаются только в том случае, если команда использует общий параметр Verbose . Дополнительные сведения см. в разделе about_CommonParameters.
- В фоновых заданиях Windows PowerShell и удаленных командах
$VerbosePreference
переменная в сеансе задания и удаленном сеансе определяет, отображается ли подробное сообщение по умолчанию. Дополнительные сведения об переменной$VerbosePreference
см. в about_Preference_Variables.
Связанные ссылки
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по