Você pode definir três tipos de pontos de interrupção no ambiente de depuração do Windows PowerShell: pontos de interrupção de variável, pontos de interrupção de comando e pontos de interrupção de linha. Entre eles, no ambiente de depuração do Windows PowerShell ISE, só os pontos de interrupção de linha são destacados e podem ser definidos usando o menu ou os atalhos de teclado. Os outros dois tipos de pontos de interrupção também podem ser definidos, só que no Painel de Comando, usando o cmdlet Set-PSBreakpoint. Você pode remover, habilitar, desabilitar e listar todos os pontos de interrupção. Esta seção descreve como executar tarefas de depuração no Windows PowerShell ISE usando os menus, onde estiverem disponíveis, e como executar um conjunto mais abrangente de comandos do Painel de Comando usando scripts.
Gerenciando pontos de interrupção
Definir um ponto de interrupção
Define um ponto de interrupção de linha em um script ou função do Windows PowerShell. Um ponto de interrupção só pode ser definido em um script depois de ter sido salvo.
Clique com o botão direito do mouse na linha onde deseja definir um ponto de interrupção e, em seguida, clique em Alternar Ponto de Interrupção. Ou então clique na linha onde deseja definir um ponto de interrupção e, no menu Depurar, clique em Alternar Ponto de Interrupção. O script a seguir é um exemplo de como você pode definir um ponto de interrupção de variável no Painel de Comando usando o cmdlet Set-PSBreakpoint.
# This command sets a breakpoint on the Server variable in the Sample.ps1 script. set-psbreakpoint -script sample.ps1 -variable Server
Listar todos os pontos de interrupção
Exibe todos os pontos de interrupção na sessão atual.
No menu Depurar, clique em Listar Pontos de Interrupção. O script a seguir é um exemplo de como você pode listar todos os pontos de interrupção no Painel de Comando usando o cmdlet Get-PSBreakpoint.
# This command lists all breakpoints in the current session. get-psbreakpoint
Remover um ponto de interrupção
Exclui um ponto de interrupção de linha específico.
Clique com o botão direito do mouse na linha onde deseja remover um ponto de interrupção e, em seguida, clique em Alternar Ponto de Interrupção. Ou então clique na linha onde deseja remover um ponto de interrupção e, no menu Depurar, clique em Alternar Ponto de Interrupção. O script a seguir é um exemplo de como remover um ponto de interrupção com uma ID especificada do Painel de Comando usando o cmdlet Remove-PSBreakpoint.
# This command deletes the breakpoint with breakpoint ID 2. remove-psbreakpoint -id 2
Remover todos os pontos de interrupção
Exclui todos os pontos de interrupção da sessão atual.
No menu Depurar, clique em Remover Todos os Pontos de Interrupção. O script a seguir é um exemplo de como remover todos os pontos de interrupção no Painel de Comando usando o cmdlet Remove-PSBreakpoint.
# This command deletes all of the breakpoints in the current session. get-breakpoint | remove-breakpoint
Desabilitar um ponto de interrupção
Desabilita um ponto de interrupção de linha específico.
Clique com o botão direito do mouse na linha onde deseja desabilitar um ponto de interrupção e, em seguida, clique em Desabilitar Ponto de Interrupção. Ou então clique na linha onde deseja desabilitar um ponto de interrupção e, no menu Depurar, clique em Desabilitar Ponto de Interrupção. O script a seguir é um exemplo de como você pode remover um ponto de interrupção com uma ID especificada do Painel de Comando usando o cmdlet Disable-PSBreakpoint.
# This command disables the breakpoint with breakpoint ID 0. disable-psbreakpoint -id 0
Desabilitar todos os pontos de interrupção
Desabilita todos os pontos de interrupção na sessão atual.
No menu Depurar, clique em Desabilitar Todos os Pontos de Interrupção. O script a seguir é um exemplo de como você pode desabilitar todos os pontos de interrupção no Painel de Comando usando o cmdlet Disable-PSBreakpoint.
# This command disables all breakpoints in the current console. # You can abbreviate this command as: "gbp | dbp". get-psbreakpoint | disable-psbreakpoint
Habilitar um ponto de interrupção
Habilita um ponto de interrupção de linha específico.
Clique com o botão direito do mouse na linha onde deseja habilitar um ponto de interrupção e, em seguida, clique em Habilitar Ponto de Interrupção. Ou então clique na linha onde deseja habilitar um ponto de interrupção e pressione F8 ou, no menu Depurar, clique em Habilitar Ponto de Interrupção. O script a seguir é um exemplo de como você pode habilitar pontos de interrupção específicos no Painel de Comando usando o cmdlet Enable-PSBreakpoint.
# This command enables breakpoints with breakpoint IDs 0, 1, and 5. enable-psbreakpoint -id 0, 1, 5
Habilitar todos os pontos de interrupção
Habilita todos os pontos de interrupção na sessão atual.
No menu Depurar, clique em Habilitar Todos os Pontos de Interrupção. O script a seguir é um exemplo de como você pode habilitar todos os pontos de interrupção no Painel de Comando usando o cmdlet Enable-PSBreakpoint.
# This command enables all breakpoints in the current session. # You can abbreviate the command as "gbp | ebp". get-psbreakpoint | enable-psbreakpoint
See Also