Megosztás a következőn keresztül:

Debug-Job

Modul:
Microsoft.PowerShell.Core Module

Egy futó háttérbeli, távoli vagy Windows PowerShell-munkafolyamat-feladat hibakeresése.

Syntax

JobParameterSet (Alapértelmezett) 

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

A Hibakeresési feladat parancsmag lehetővé teszi a feladatokon belül futó szkriptek hibakeresését. A parancsmag a Windows PowerShell-munkafolyamatok, a háttérfeladatok és a távoli munkamenetekben futó feladatok hibakeresésére szolgál. Hibakeresési feladat 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ő kilép parancs leállítja a feladatot és futtatja a szkriptet. A Windows PowerShell 5.0-tól kezdve a kilépési 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

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"

Ez a parancs megszakít egy 3-as azonosítójú futó feladatot.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

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:False
Fennmaradó argumentumokból származó érték:False

-Id

A futó feladat azonosítószámát határozza meg. Egy feladat azonosítószámának lekéréséhez futtassa a Get-Job parancsmagot.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

JobIdParameterSet
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InstanceId

Egy futó feladat példányazonosítójának GUID azonosítóját adja meg. Egy feladat InstanceId lekéréséhez futtassa a Get-Job parancsmagot, és az eredményeket egy Format-* parancsmagba állítva, az alábbi példában látható módon:

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

Paramétertulajdonságok

Típus:Guid
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

JobInstanceIdParameterSet
Position:0
Kötelező:True
Folyamatból származó érték:False
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 a változóban hibakeresésre használni kívánt futó feladatot, majd ennek a paraméternek az értékeként adja meg a változót.

Paramétertulajdonságok

Típus:Job
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

JobParameterSet
Position:0
Kötelező:True
Folyamatból származó érték:True
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 olyan parancsmagokban, mint a Invoke-Command és a Start-Job.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

JobNameParameterSet
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

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: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.

Bevitelek

System.Management.Automation.RemotingJob