Med cmdleten Debug-Job kan du felsöka skript som körs i jobb. Cmdleten är utformad för att felsöka PowerShell-arbetsflödesjobb, bakgrundsjobb och jobb som körs i fjärrsessioner.
Debug-Job accepterar ett jobbobjekt, namn, ID eller instans-ID som indata och startar en felsökningssession i skriptet som körs. Felsökningskommandot quit stoppar jobbet och skriptet som körs. Kommandot exit kopplar från felsökningsprogrammet och gör att jobbet kan fortsätta att köras.
Exempel
Exempel 1: Felsöka ett jobb efter jobb-ID
Det här kommandot avbryter ett jobb som körs med ett ID på 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"
Parametrar
-BreakAll
Möjliggör att du kan bryta direkt vid aktuell position när debuggern kopplas in.
Definierar ett körande jobbobjekt. Det enklaste sättet att använda den här parametern är att spara resultatet av ett Get-Job kommando som returnerar det jobb som körs som du vill felsöka i en variabel och sedan ange variabeln som värdet för den här parametern.
Anger ett jobb genom det beskrivande namnet på jobbet. När du startar ett jobb kan du ange ett jobbnamn genom att lägga till parametern JobName i cmdletar som Invoke-Command och Start-Job.
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Källan för det här innehållet finns på GitHub, där du även kan skapa och granska ärenden och pull-begäranden. Se vår deltagarguide för mer information.