Debug-Job

参考

模块:: Microsoft.PowerShell.Core

调试正在运行的后台、远程或Windows PowerShell工作流作业。

语法

Debug-Job
     [-Job] <Job>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Job
     [-Name] <String>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Job
     [-Id] <Int32>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Debug-Job
     [-InstanceId] <Guid>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

使用 Debug-Job cmdlet 可以调试作业中运行的脚本。该 cmdlet 旨在调试在远程会话中运行的工作流作业、后台作业和作业Windows PowerShell。 Debug-Job 接受正在运行的作业对象、名称、ID 或实例 ID 作为输入，并在正在运行的脚本上启动调试会话。调试器退出命令停止作业并运行脚本。从 Windows PowerShell 5.0 开始，退出命令会分离调试器，并允许作业继续运行。

示例

示例 1：按作业 ID 调试作业

PS C:\> Debug-Job -ID 3
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            RemoteJob       Running       True            PowerShellIx         TestWFDemo1.ps1
          Entering debug mode. Use h or ? for help.

          Hit Line breakpoint on 'C:\TestWFDemo1.ps1:8'

          At C:\TestWFDemo1.ps1:8 char:5
          +     Write-Output -InputObject "Now writing output:"
          +     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
          [DBG:PowerShellIx]: PS C:\> > list

              3:
              4:  workflow SampleWorkflowTest
              5:  {
              6:      param ($MyOutput)
              7:
              8:*     Write-Output -InputObject "Now writing output:"
              9:      Write-Output -Input $MyOutput
             10:
             11:      Write-Output -InputObject "Get PowerShell process:"
             12:      Get-Process -Name powershell
             13:
             14:      Write-Output -InputObject "Workflow function complete."
             15:  }
             16:
             17:  # Call workflow function
             18:  SampleWorkflowTest -MyOutput "Hello"

此命令将分解为 ID 为 3 的正在运行的作业。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

指定正在运行的作业的 ID 号。若要获取作业的 ID 号，请运行 Get-Job cmdlet。

Type:	Int32
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceId

指定正在运行的作业的实例 ID GUID。若要获取作业的 InstanceId ，请运行 Get-Job cmdlet，将结果管道到 Format-* cmdlet 中，如以下示例所示：

Get-Job | Format-List -Property Id,Name,InstanceId,State

Type:	Guid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Job

指定正在运行的作业对象。使用此参数的最简单方法是保存 Get-Job 命令的结果，该命令返回要在变量中调试的正在运行的作业，然后将变量指定为此参数的值。

Type:	Job
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

按作业的友好名称指定作业。启动作业时，可以通过在 cmdlet（如 Invoke-Command 和 Start-Job）中添加 JobName 参数来指定作业名称。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。此 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

System.Management.Automation.RemotingJob