Set-PSDebug 帮助信息

如下说明是翻译: help Set-PSDebug 产生的帮助信息.

译者: Edengundam(马涛)

 

Set-PSDebug

 

大纲

控制脚本调试模式的启动与停止, 设置跟踪级别, 进入严格(strict)模式.

 

语法

Set-PSDebug [-trace <int>] [-step] [-strict] [<CommonParameters>]

 

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

 

详细描述

控制脚本调试模式的启动与停止, 设置跟踪级别, 进入严格(strict)模式. 此cmdlet允许你控制Windows PowerShell解释器的调试选项. 当参数Trace设置为1时, 只有脚本被执行的行被跟踪.(译者注:这里的脚本包括在命令行的输入. ) 当参数设置为2时, 变量赋值, 函数和脚本调用也将会被跟踪.

 

如果指定了参数Step, 用户将会在执行脚本每一行之前, 看到和参数Confirm一样的选项菜单.

 

在单步模式中, 选项菜单不同选项的响应行为如下所述:

 

·         "Yes"执行当前行

·         "Yes to All" 退出单步模式(脚本将会继续执行而不再提示任何信息)

·         "No"和"No To All" 退出脚本

·         "Suspend"启动一个嵌套shell, 当从前套shell退出将会重新显示选项菜单.

 

参数

 

-trace <int>

指定跟踪级别:

 

·         0 - 关闭脚本跟踪

·         1 - 对执行的脚本行进行跟踪

·         2 - 对执行的脚本行, 变量赋值, 函数和脚本调用进行跟踪.

 

强制参数?

False

参数位置?

Named

默认值

1

允许从管道绑定输入?

False

允许通配符扩展?

False

 

-step <SwitchParameter>

打开脚本单步模式. 在每行运行之前, 用户被提示, 以允许停止, 继续或进入新的解释器环境检查脚本的运行状态操作.

 

指定Step时, 将会把参数Trace设置为1.

 

强制参数?

False

参数位置?

Named

默认值

False

允许从管道绑定输入?

False

允许通配符扩展?

False

 

-off <SwitchParameter>

关闭所有脚本调试机制.

 

强制参数?

false

参数位置?

named

默认值

False

允许从管道绑定输入?

false

允许通配符扩展?

false

 

-strict <SwitchParameter>

指示如果变量在赋值前没有赋值, 解释器抛出异常.

 

强制参数?

false

参数位置?

named

默认值

False

允许从管道绑定输入?

false

允许通配符扩展?

false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

注意

 

更多信息, 输入"Get-Help Set-PsDebug  -detailed".需要技术信息, 输入"Get-Help Set-PsDebug -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

例1

 

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

 

此命令将跟踪级别设置为2, 然后执行脚本显示数字1, 2和3.

 

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

 

例2

 

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

 

此命令打开单步模式, 然后执行脚本显示数字1, 2和3.

 

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

 

例3

 

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

 

此命令关闭所有调试信息, , 然后执行脚本显示数字1, 2和3.

 

1

2

3

 

例4

 

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

 

此命令指示解释器进入严格模式, 然后试图访问未赋值变量.

 

变量$NewVar由于没有赋值因此无法访问.

 

At line:1 char:28

+ Set-PsDebug -strict;$NewVar <<<<

 

相关链接

Write-Debug