Debug-Job
Debuguje uruchomione zadanie przepływu pracy w tle, zdalnym lub Windows PowerShell.
Składnia
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>]
Opis
Polecenie cmdlet Debug-Job umożliwia debugowanie skryptów działających w ramach zadań. Polecenie cmdlet jest przeznaczone do debugowania zadań Windows PowerShell przepływów pracy, zadań w tle i zadań uruchomionych w sesjach zdalnych. Zadanie debugowania akceptuje uruchomiony obiekt zadania, nazwę, identyfikator lub identyfikator wystąpienia jako dane wejściowe i uruchamia sesję debugowania na uruchomionym skrycie. Debuger zamyka polecenie zatrzymuje zadanie i uruchamia skrypt. Począwszy od Windows PowerShell 5.0, polecenie exit odłącza debugera i umożliwia kontynuowanie działania zadania.
Przykłady
Przykład 1. Debugowanie zadania według identyfikatora zadania
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"
To polecenie dzieli się na uruchomione zadanie o identyfikatorze 3.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Określa identyfikator uruchomionego zadania. Aby uzyskać identyfikator zadania, uruchom polecenie cmdlet Get-Job.
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
Określa identyfikator GUID wystąpienia uruchomionego zadania. Aby uzyskać identyfikator InstanceId zadania, uruchom polecenie cmdlet Get-Job , potokując wyniki do polecenia cmdlet Format-* , jak pokazano w poniższym przykładzie:
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
Określa uruchomiony obiekt zadania. Najprostszym sposobem użycia tego parametru jest zapisanie wyników polecenia Get-Job zwracającego uruchomione zadanie, które chcesz debugować w zmiennej, a następnie określenie zmiennej jako wartości tego parametru.
Type: | Job |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Określa zadanie według przyjaznej nazwy zadania. Po uruchomieniu zadania można określić nazwę zadania, dodając parametr JobName w poleceniach cmdlet, takich jak Invoke-Command i Start-Job.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
System.Management.Automation.RemotingJob