共用方式為

Debug-Job

模組:
Microsoft.PowerShell.Core Module

偵錯執行中的背景、遠端或 Windows PowerShell 工作流程作業。

語法

JobParameterSet (預設值) 

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

JobNameParameterSet 

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

JobIdParameterSet 

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

JobInstanceIdParameterSet 

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

Description

Debug-Job Cmdlet 可讓您偵錯在作業內執行的腳本。 Cmdlet 的設計目的是偵錯在遠端會話中執行的 Windows PowerShell 工作流程作業、背景工作和作業。 Debug-Job 接受執行中的作業對象、名稱、標識碼或實例識別碼做為輸入，並在正在執行的腳本上啟動偵錯會話。 調試程式 結束 命令會停止作業並執行腳本。 從 Windows PowerShell 5.0 開始，結束 命令會中斷調試程序連結，並允許作業繼續執行。

範例

範例 1：依作業標識符對作業進行偵錯

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"

此命令會分成標識碼為 3 的執行中作業。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Id

指定執行中作業的識別碼。 若要取得作業的標識碼，請執行 Get-Job Cmdlet。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

JobIdParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InstanceId

指定執行中作業的實例識別碼 GUID。 若要取得作業的 InstanceId，請執行 Get-Job Cmdlet，將結果管入 Format-* Cmdlet，如下列範例所示：

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

參數屬性

類型:Guid
預設值:None
支援萬用字元:False
不要顯示:False

參數集

JobInstanceIdParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Job

指定執行中的作業物件。 使用此參數最簡單的方式是儲存 Get-Job 命令的結果，該命令會傳回您要在變數中偵錯的執行中作業，然後將變數指定為此參數的值。

參數屬性

類型:Job
預設值:None
支援萬用字元:False
不要顯示:False

參數集

JobParameterSet
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

以作業的易記名稱指定作業。 當您啟動作業時，您可以在 cmdlet 中新增 JobName 參數來指定作業名稱，例如 Invoke-Command 和 Start-Job。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

JobNameParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.Management.Automation.RemotingJob