Debug-Job

  • Reference
Modul:
Microsoft.PowerShell.Core

Ladí spuštěné pozadí nebo vzdálenou úlohu.

Syntaxe

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

Description

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, který je spuštěný. Příkaz ladicího programu quit zastaví úlohu a spustí skript. Příkaz exit odpojte ladicí program a umožní ú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.

Tento parametr byl přidán v PowerShellu 7.2.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje číslo ID spuštěné úlohy. Pokud chcete získat číslo ID úlohy, spusťte rutinu Get-Job .

Typ:Int32
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InstanceId

Určuje identifikátor GUID ID instance spuštěné úlohy.

Typ:Guid
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Job

Určuje spuštěný objekt úlohy. Nejjednodušším způsobem, jak tento parametr použít, je uložit výsledky příkazu, který vrátí spuštěnou Get-Job úlohu, kterou chcete ladit v proměnné, a pak proměnnou zadat jako hodnotu tohoto parametru.

Typ:Job
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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 Invoke-Command je například a Start-Job.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.Management.Automation.RemotingJob