Debug-Job

  • Referencia
Modul:
Microsoft.PowerShell.Core

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

Syntax

Debug-Job
     [-Job] <Job>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-Name] <String>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-Id] <Int32>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Job
     [-InstanceId] <Guid>
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

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 Bemenetként elfogad egy futó feladatobjektumot, nevet, azonosítót vagy példányazonosítót, és elindít egy hibakeresési munkamenetet a futó szkripten. A hibakereső quit parancs leállítja a feladatot és futtatja a 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 egy 3 azonosítójú futó feladatra vált.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstanceId

Egy futó feladat példányazonosítójának GUID azonosítóját adja meg.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Job

Futó feladatobjektumot ad meg. Ennek a paraméternek a legegyszerűbb módja egy Get-Job olyan 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.

Type:Job
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Egy feladatot a feladat rövid 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 az Invoke-Command és Start-Job.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

System.Management.Automation.RemotingJob