Rutina Debug-Job umožňuje ladit skripty spuštěné v rámci úloh. Rutina je navržená tak, aby ladí úlohy pracovního postupu PowerShellu, úlohy na pozadí a úlohy spuštěné ve vzdálených relacích.
Debug-Job přijímá spuštěný objekt úlohy, název, ID nebo ID instance jako vstup a spustí ladicí relaci ve skriptu, na kterém běží. Ladicí program quit příkaz zastaví úlohu a spustí skript. Příkaz exit odpojte ladicí program a umožňuje úlohu pokračovat ve spuštění.
Příklady
Příklad 1: Ladění úlohy podle ID úlohy
Tento příkaz se rozdělí na spuštěnou úlohu s ID 3.
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"
Parametry
-BreakAll
Umožňuje okamžitě přerušit aktuální umístění při připojení ladicího programu.
Určuje spuštěný objekt úlohy. Nejjednodušší způsob, jak tento parametr použít, je uložit výsledky příkazu Get-Job, který vrátí spuštěnou úlohu, kterou chcete ladit v proměnné, a pak tuto proměnnou zadat jako hodnotu tohoto parametru.
Určuje úlohu popisným názvem úlohy. Při spuštění úlohy můžete zadat název úlohy přidáním parametru JobName v rutinách, jako jsou Invoke-Command a Start-Job.
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.