Выводит сообщение отладки на консоль.
Синтаксис
Write-Debug [-Message] <string> [<CommonParameters>]
Описание
Командлет Write-Debug выводит на консоль сообщения отладки из скрипта или команды.
По умолчанию сообщения отладки не отображаются на консоли, но их можно вывести с помощью параметра Debug или переменной $DebugPreference.
Параметры
-Message <string>
Задает сообщение отладки для отправки на консоль.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue) |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Строку, содержащую сообщение отладки, можно передать командлету Write-Debug по конвейеру. |
|
Выходные данные |
Нет Командлет Write-Debug осуществляет запись только в поток отладки. Он не возвращает никаких выходных данных. |
Пример 1
C:\PS>Write-Debug "Cannot open file." Описание ----------- Эта команда выводит сообщение отладки. Поскольку переменная $DebugPreference имеет значение "SilentlyContinue", на консоли сообщение не отображается.
Пример 2
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> Write-Debug "Cannot open file." -debug DEBUG: Cannot open file. Описание ----------- В этом примере показано, как с помощью общего параметра Debug переопределять значение переменной $DebugPreference для конкретной команды. Первая команда выводит значение переменной $DebugPreference, которое по умолчанию равно "SilentlyContinue". Вторая команда записывает сообщение отладки, но из-за значения переменной $DebugPreference оно не появляется. Третья команда выводит сообщение отладки. Она использует общий параметр Debug, чтобы переопределить значение $DebugPreference и вывести сообщение отладки, выдаваемое этой командой. В результате сообщение отладки отображается, несмотря на то что переменная $DebugPreference имеет значение "SilentlyContinue". Дополнительные сведения об общем параметре Debug см. в разделе about_CommonParameters.
Пример 3
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> $DebugPreference = "Continue" C:\PS> Write-Debug "Cannot open file." DEBUG: Cannot open file. Описание ----------- В этой команде показано, как изменение значения переменной $DebugPreference влияет на отображение сообщений отладки. Первая команда выводит значение переменной $DebugPreference, которое по умолчанию равно "SilentlyContinue". Вторая команда записывает сообщение отладки, но из-за значения переменной $DebugPreference оно не появляется. Третья команда присваивает переменной $DebugPreference значение "Continue". Четвертая команда записывает сообщение отладки, которое отображается на консоли. Дополнительные сведения о переменной $DebugPreference см. в разделе about_Preference_Variables.