Rutina Debug-Job umožňuje ladit skripty spuštěné v rámci úloh.
Tato rutina je navržená tak, aby ladí úlohy pracovního postupu Windows PowerShellu, úlohy na pozadí a úlohy spuštěné ve vzdálených relacích.
ladění 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ý.
Ladicí program ukončí příkaz zastaví úlohu a spustí skript.
Počínaje windows PowerShellem 5.0 ukončete příkaz odpojte ladicí program a umožní úlohu pokračovat ve spuštění.
Příklady
Příklad 1: Ladění úlohy podle ID úlohy
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"
Tento příkaz se rozdělí na spuštěnou úlohu s ID 3.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
False
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
viz
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Id
Určuje číslo ID spuštěné úlohy.
Pokud chcete získat číslo ID úlohy, spusťte rutinu Get-Job.
Vlastnosti parametru
Typ:
Int32
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
JobIdParameterSet
Position:
0
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-InstanceId
Určuje identifikátor GUID ID instance spuštěné úlohy.
Pokud chcete získat InstanceId úlohy, spusťte rutinu Get-Job, která výsledky prodá do rutiny Format–* , jak je znázorněno v následujícím příkladu:
Určuje spuštěný objekt úlohy.
Nejjednodušší způsob, jak tento parametr použít, je uložit výsledky příkazu Get-Job, který vrátí spuštěnou úlohu, kterou chcete ladit v proměnné, a pak proměnnou zadat jako hodnotu tohoto parametru.
Vlastnosti parametru
Typ:
Job
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
JobParameterSet
Position:
0
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
True
Hodnota ze zbývajících argumentů:
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 jsou Invoke-Command a Start-Job.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
JobNameParameterSet
Position:
0
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-WhatIf
Ukazuje, co se stane, když se příkaz spustí.
Příkazový modul nebyl spuštěn.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
False
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
Wi
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.