The Debug-Job cmdlet lets you debug scripts that are running within jobs.
The cmdlet is designed to debug Windows PowerShell Workflow jobs, background jobs, and jobs running in remote sessions.
Debug-Job accepts a running job object, name, ID, or instance ID as input, and starts a debugging session on the script it is running.
The debugger quit command stops the job and running script.
Starting in Windows PowerShell 5.0, the exit command detaches the debugger, and allows the job to continue to run.
例
Example 1: Debug a job by job 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"
This command breaks into a running job with an ID of 3.
パラメーター
-Confirm
Prompts you for confirmation before running the cmdlet.
パラメーターのプロパティ
型:
SwitchParameter
規定値:
False
ワイルドカードのサポート:
False
DontShow:
False
Aliases:
cf
パラメーター セット
(All)
配置:
Named
必須:
False
パイプラインからの値:
False
プロパティ名別のパイプラインからの値:
False
残りの引数からの値:
False
-Id
Specifies the ID number of a running job.
To get the ID number of a job, run the Get-Job cmdlet.
パラメーターのプロパティ
型:
Int32
規定値:
None
ワイルドカードのサポート:
False
DontShow:
False
パラメーター セット
JobIdParameterSet
配置:
0
必須:
True
パイプラインからの値:
False
プロパティ名別のパイプラインからの値:
False
残りの引数からの値:
False
-InstanceId
Specifies the instance ID GUID of a running job.
To get the InstanceId of a job, run the Get-Job cmdlet, piping the results into a Format-* cmdlet, as shown in the following example:
Specifies a running job object.
The simplest way to use this parameter is to save the results of a Get-Job command that returns the running job that you want to debug in a variable, and then specify the variable as the value of this parameter.
パラメーターのプロパティ
型:
Job
規定値:
None
ワイルドカードのサポート:
False
DontShow:
False
パラメーター セット
JobParameterSet
配置:
0
必須:
True
パイプラインからの値:
True
プロパティ名別のパイプラインからの値:
True
残りの引数からの値:
False
-Name
Specifies a job by the friendly name of the job.
When you start a job, you can specify a job name by adding the JobName parameter, in cmdlets such as Invoke-Command and Start-Job.
パラメーターのプロパティ
型:
String
規定値:
None
ワイルドカードのサポート:
False
DontShow:
False
パラメーター セット
JobNameParameterSet
配置:
0
必須:
True
パイプラインからの値:
False
プロパティ名別のパイプラインからの値:
False
残りの引数からの値:
False
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
パラメーターのプロパティ
型:
SwitchParameter
規定値:
False
ワイルドカードのサポート:
False
DontShow:
False
Aliases:
wi
パラメーター セット
(All)
配置:
Named
必須:
False
パイプラインからの値:
False
プロパティ名別のパイプラインからの値:
False
残りの引数からの値:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.