通过

Set-PSDebug

  • 参考
模块:
Microsoft.PowerShell.Core

打开和关闭脚本调试功能，设置跟踪级别，并切换严格模式。

语法

Set-PSDebug
   [-Trace <Int32>]
   [-Step]
   [-Strict]
   [<CommonParameters>]
Set-PSDebug
   [-Off]
   [<CommonParameters>]

说明

Set-PSDebug cmdlet 打开和关闭脚本调试功能，设置跟踪级别，并切换严格模式。 默认情况下，PowerShell 调试功能处于关闭状态。

当 Trace 参数的值为 1时，将跟踪运行每个脚本行。 当参数具有 2值时，也会跟踪变量赋值、函数调用和脚本调用。 如果指定了 步骤 参数，则会在运行脚本的每一行之前提示你。

示例

示例 1：设置跟踪级别

此示例将跟踪级别设置为 2，然后运行显示数字 1、2 和 3 的脚本。

Set-PSDebug -Trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PSDebug -Trace 2; foreach ($i in  >>>> 1..3) {$i}
DEBUG:     ! SET $foreach = 'IEnumerator'.
DEBUG:    1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG:     ! SET $i = '1'.
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}
DEBUG:     ! SET $i = '2'.
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}
DEBUG:     ! SET $i = '3'.
DEBUG:    1+ Set-PSDebug -Trace 2; foreach ($i in 1..3) { >>>> $i}
3
DEBUG:    1+ Set-PSDebug -Trace 2; foreach ( >>>> $i in 1..3) {$i}
DEBUG:     ! SET $foreach = ''.

示例 2：启用单步执行

此示例打开单步执行，然后运行显示数字 1、2 和 3 的脚本。

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

示例 3：使用严格模式

此示例将 PowerShell 置于严格模式下，并尝试访问没有分配值的变量。

Set-PSDebug -Strict; $NewVar

The variable '$NewVar' cannot be retrieved because it has not been set.
At line:1 char:22
+ Set-PSDebug -Strict; $NewVar

示例 4：关闭调试功能

此示例关闭所有调试功能，然后运行显示数字 1、2 和 3 的脚本。

Set-PSDebug -Off; foreach ($i in 1..3) {$i}

1
2
3

参数

-Off

关闭所有脚本调试功能。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Step

打开脚本单步执行。 在每个行运行之前，PowerShell 会提示你停止、继续或输入新的解释器级别来检查脚本的状态。

指定 Step 参数会自动设置 1的跟踪级别。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Strict

指定在脚本中引用之前，必须为变量赋值。 如果在分配值之前引用变量，PowerShell 将返回异常错误。 这相当于 Set-StrictMode -Version 1。 有关详细信息，请参阅 Set-StrictMode。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Trace

指定脚本中每行的跟踪级别。 每一行在运行时都会进行跟踪。

此参数的可接受值如下所示：

  • 0：关闭脚本跟踪。
  • 1：运行脚本行时跟踪脚本行。
  • 2：跟踪脚本行、变量赋值、函数调用和脚本。
类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

无法将输入管道传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。