A Debug-Job parancsmag lehetővé teszi a feladatokon belül futó szkriptek hibakeresését. A parancsmag a PowerShell-munkafolyamat-feladatok, a háttérfeladatok és a távoli munkamenetekben futó feladatok hibakeresésére szolgál.
Debug-Job egy futó feladatobjektumot, nevet, azonosítót vagy példányazonosítót fogad bemenetként, és elindít egy hibakeresési munkamenetet a futó szkripten. A hibakereső quit parancs leállítja a feladatot és a futó szkriptet. A exit parancs leválasztja a hibakeresőt, és engedélyezi a feladat futtatását.
Példák
1. példa: Feladat hibakeresése feladatazonosító alapján
Ez a parancs megszakít egy 3-as azonosítójú futó feladatot.
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"
Paraméterek
-BreakAll
Lehetővé teszi, hogy az aktuális helyen azonnal megszakítsa a végrehajtást, amikor a hibakereső elindul.
Ez a paraméter a PowerShell 7.2-ben lett hozzáadva.
Paramétertulajdonságok
Típus:
SwitchParameter
Alapértelmezett érték:
None
Támogatja a helyettesítő karaktereket:
False
DontShow:
False
Paraméterkészletek
(All)
Position:
Named
Kötelező:
False
Folyamatból származó érték:
False
Folyamatból származó érték tulajdonságnév alapján:
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
-Job
Futó feladatobjektumot ad meg. Ennek a paraméternek a legegyszerűbb módja egy Get-Job parancs eredményeinek mentése, amely visszaadja azt a futó feladatot, amelyet egy változóban szeretne hibakeresésre használni, majd a paraméter értékeként adja meg a változót.
Folyamatból származó érték tulajdonságnév alapján:
True
Fennmaradó argumentumokból származó érték:
False
-Name
Egy feladatot a feladat barátságos neve alapján határoz meg. Feladat indításakor megadhatja a feladat nevét a JobName paraméter hozzáadásával, például Invoke-Command és Start-Jobparancsmagokban.
Folyamatból származó érték tulajdonságnév alapján:
False
Fennmaradó argumentumokból származó érték:
False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.