Compartilhar via


Set-PSDebug

Ativa e desativa os recursos de depuração de script, define o nível de rastreamento e alterna o modo estrito.

Sintaxe

Set-PSDebug [-Off] [<CommonParameters>]

Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]

Descrição

O cmdlet Set-PSDebug ativa e desativa os recursos de depuração de script, define o nível de rastreamento e alterna o modo estrito.

Quando o parâmetro Trace estiver definido como 1, cada linha de script será rastreada quando for executada. Quando o parâmetro estiver definido como 2, as atribuições de variáveis, as chamadas de função e as chamadas de script também serão rastreadas. Se o parâmetro Step for especificado, você receberá um aviso antes de cada linha de script ser executada.

Parâmetros

-Off

Desativa todos os recursos de depuração do script.

Observação: um comando "Set-StrictMode -off" desabilita o conjunto de verificação por um comando "set-psdebug -strict". Para obter mais informações, consulte Set-StrictMode.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Step

Ativa as etapas do script. Antes de cada linha ser executada, o usuário será solicitado a parar, continuar ou inserir um novo nível de interpretador para inspecionar o estado do script.

Observação: se o parâmetro Step for especificado, o nível de rastreamento será automaticamente definido como 1.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Strict

Especifica que o interpretador deverá emitir uma exceção se uma variável for referenciada antes de um valor ser atribuído a ela.

Observação: um comando "Set-StrictMode -off" desabilita o conjunto de verificação por um comando "set-psdebug -strict". Para obter mais informações, consulte Set-StrictMode.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Trace <int>

Especifica o nível de rastreamento:

0 - Desativar o rastreamento do script

1 - Rastrear linhas do script conforme elas são executadas

2 - Rastrear linhas do script, atribuições de variáveis, chamadas de função e scripts.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

Nenhum

Este cmdlet não retorna nenhuma saída.

Exemplo 1

C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3

Descrição
-----------
Esse comando define o nível de rastreamento como 2 e, em seguida, executa um script que exibe os números 1, 2 e 3.





Exemplo 2

C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
   1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):a
DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3

Descrição
-----------
Esse comando ativa as etapas e, em seguida, 
executa um script que exibe os números 1, 2 e 3.





Exemplo 3

C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}

1
2
3

Descrição
-----------
Esse comando desativa todos os recursos de depuração e executa um script que exibe os números 1, 2 e 3.





Exemplo 4

C:\PS>set-psdebug -strict; $NewVar

The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<

Descrição
-----------
Esse comando coloca o interpretador em modo estrito e tenta acessar uma variável que não foi definida.





Consulte também

Conceitos

about_Debuggers
Debug-Process
Set-PSBreakpoint
Set-StrictMode
Write-Debug