Debug-Job
Ladí spuštěnou úlohu pracovního postupu na pozadí, vzdáleném nebo Windows PowerShell.
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
Rutina Debug-Job umožňuje ladit skripty spuštěné v rámci úloh. Tato rutina je navržená tak, aby ladí Windows PowerShell úlohy pracovního postupu, úlohy na pozadí a úlohy spuštěné ve vzdálených relacích. Úloha ladění přijímá spuštěný objekt úlohy, název, ID nebo ID instance jako vstup a spustí ladicí relaci ve skriptu, na kterém běží. Ladicí program ukonče příkaz zastaví úlohu a spustí skript. Počínaje Windows PowerShell 5.0 odpojil příkaz exit ladicí program a umožňuje ú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 rutiny zobrazí výzvu k potvrzení.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Určuje číslo ID spuštěné úlohy. Pokud chcete získat číslo ID úlohy, spusťte rutinu Get-Job.
| Type: | Int32 |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Určuje identifikátor GUID ID instance spuštěné úlohy. Pokud chcete získat Id instance úlohy, spusťte rutinu Get-Job , která výsledky přepíná do rutiny Format-*, jak je znázorněno v následujícím příkladu:
Get-Job | Format-List -Property Id,Name,InstanceId,State
| Type: | Guid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-Job , který vrátí spuštěnou úlohu, kterou chcete ladit v proměnné, a pak zadat proměnnou jako hodnotu tohoto parametru.
| Type: | Job |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Určuje úlohu podle popisného názvu ú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.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
System.Management.Automation.RemotingJob