Write-Debug

Статья
10/30/2009

Выводит сообщение отладки на консоль.

Синтаксис

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.

См. также

Концепции

Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning

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