Set-PSBreakpoint

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

Descrição
-----------
Esse comando define um ponto de interrupção na linha 5 do script Sample.ps1. Como resultado, quando o script é executado, a execução é interrompida imediatamente antes da linha 5 ser executada.

Quando você define um novo ponto de interrupção por número de linha, o cmdlet Set-PSBreakpoint gera um objeto de ponto de interrupção de linha (System.Management.Automation.LineBreakpoint) que inclui a ID do ponto de interrupção e a contagem de ocorrências, conforme mostrado na saída do exemplo a seguir.

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

Descrição
-----------
Esse comando cria um ponto de interrupção de comando na função Increment função do cmdlet Sample.ps1. O script interrompe a execução imediatamente antes de cada chamada para a função especificada.

O resultado é um objeto de ponto de interrupção de comando. Antes de o script ser executado, o valor da propriedade HitCount é 0.

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

Descrição
-----------
Esse comando define um ponto de interrupção na variável Server do script Sample.ps1. Ele usa o parâmetro Mode com um valor de ReadWrite para interromper a execução quando o valor da variável é lido e imediatamente antes do valor ser alterado.

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

Descrição
-----------
Esse comando define um ponto de interrupção em cada comando no script Sample.ps1 que começa com "write", como "write-host".

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

Descrição
-----------
Esse comando só interrompe execução na função DiskTest script Test.ps1 quando o valor da variável $disk é maior que 2.

Ele usa o cmdlet Set-PSBreakpoint para definir um ponto de interrupção de comando na função DiskTest. O valor da ação é um bloco de script que testa o valor da variável $disk na função.

A ação usará a palavra-chave BREAK para interromper a execução se a condição for atendida. A alternativa (e o padrão) é 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>>>

Descrição
-----------
Esse comando define um ponto de interrupção na função CheckLog. Como o comando não especifica um script, o ponto de interrupção é definido em qualquer coisa executada na sessão atual. O depurador é interrompido quando a função é chamada, não quando ela é declarada.

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

Descrição
-----------
Esse comando define três pontos de interrupção de linha no script Sample.ps1. Ele define um ponto de interrupção na coluna 2 em cada uma das linhas especificadas no script. A ação especificada no parâmetro Action é aplicada a todos os pontos de interrupção.