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 |
None Você não pode canalizar a entrada para este cmdlet. |
|
Saídas |
None 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.
See Also