Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -Variable <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Action <scriptblock>] [<CommonParameters>]

C:\PS>set-psbreakpoint -script sample.ps1 -line 5

Column	 : 0
Line	 : 5
Action	 :
Enabled	: True
HitCount   : 0
Id		 : 0
Script	 : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Описание
-----------
Эта команда устанавливает точку останова на строке 5 скрипта Sample.ps1. В результате после запуска скрипта его выполнение будет приостановлено непосредственно перед выполнением строки 5.

При установке новой точки останова по номеру строки командлет Set-PSBreakpoint создает объект точки останова строки (System.Management.Automation.LineBreakpoint), который включает идентификатор точки останова, а также число срабатываний, как показано в примере вывода.

C:\PS>set-psbreakpoint -command Increment -script sample.ps1

Command	: Increment
Action	 :
Enabled	: True
HitCount   : 0
Id		 : 1
Script	 : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Описание
-----------
Эта команда создает точку останова команды на функции Increment в скрипте Sample.ps1. Выполнение скрипта останавливается непосредственно перед вызовом указанной функции.

Результатом выполнения команды является объект точки останова. Перед запуском скрипта значение свойства HitCount равно 0.

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

Описание
-----------
Эта команда устанавливает точку останова на переменной Server в скрипте Sample.ps1. Чтобы остановить выполнение при чтении переменной или перед изменением ее значения команда использует параметр Mode со значением ReadWrite.

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

Описание
-----------
Эта команда устанавливает точку останова на каждой команде скрипта Sample.ps1, начинающейся с "write," например "write-host".

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

Описание
-----------
Эта команда останавливает выполнение на функции DiskTest скрипта Test.ps1 только в том случае, если значение переменной $disk больше 2.

Она использует командлет Set-PSBreakpoint, чтобы установить точку останова команды на функции DiskTest. Значением параметра action является блок скрипта, который проверяет значение переменной $disk в функции.

В скрипте используется ключевое слово BREAK, чтобы остановить выполнение, если условие соблюдается. Альтернативный вариант (он используется по умолчанию) — CONTINUE.

C:\PS>set-psbreakpoint -command checkpoint-computer

Id	 : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

C:\PS> function CheckLog {
>> get-eventlog -log Application | 
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
C:\PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'
C:\PS>>>

Описание
-----------
Эта команда устанавливает точку останова на функции CheckLog. Поскольку в команде не указан скрипт, точка останова относится ко всем выполняемым в данном сеансе командам. Отладчик прерывает выполнение при вызове функции, а не при ее объявлении.

C:\PS>set-psbreakpoint -script sample.ps1 -line 1, 14, 19 -column 2 -action {&(log.ps1)}

Column	 : 2
Line	 : 1
Action	 :
Enabled	: True
HitCount   : 0
Id		 : 6
Script	 : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column	 : 2
Line	 : 14
Action	 :
Enabled	: True
HitCount   : 0
Id		 : 7
Script	 : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column	 : 2
Line	 : 19
Action	 :
Enabled	: True
HitCount   : 0
Id		 : 8
Script	 : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Описание
-----------
Эта команда устанавливает три точки останова строк в скрипте Sample.ps1. Она устанавливает по одной точке останова в столбце 2 каждой из строк скрипта. Действие, указанное в параметре Action, относится ко всем точкам останова.