Поделиться через

Debug-Job

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Выполняет отладку запущенного фонового, удаленного или Windows PowerShell задания рабочего процесса.

Синтаксис

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>]

Описание

Командлет Debug-Job позволяет выполнять отладку скриптов, выполняемых в заданиях. Командлет предназначен для отладки Windows PowerShell рабочих процессов, фоновых заданий и заданий, выполняемых в удаленных сеансах. Debug-Job принимает объект, имя, идентификатор или идентификатор экземпляра выполняющегося задания в качестве входных данных и запускает сеанс отладки для выполняемого скрипта. Команда завершения отладчика останавливает задание и выполнение скрипта. Начиная с Windows PowerShell 5.0, команда выхода отсоединяет отладчик и позволяет продолжить выполнение задания.

Примеры

Пример 1. Отладка задания по идентификатору задания

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"

Эта команда разбивается на выполняемое задание с идентификатором 3.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Id

Указывает идентификатор выполняющегося задания. Чтобы получить идентификатор задания, выполните командлет Get-Job.

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

-InstanceId

Указывает ИДЕНТИФИКАТОР экземпляра GUID выполняющегося задания. Чтобы получить InstanceId задания, запустите командлет Get-Job , указав результаты в командлет Format-*, как показано в следующем примере:

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

Указывает выполняющийся объект задания. Самый простой способ использовать этот параметр — сохранить результаты команды Get-Job , которая возвращает выполняющееся задание, которое требуется отладить в переменной, а затем указать переменную в качестве значения этого параметра.

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

-Name

Указывает задание по понятному имени задания. При запуске задания можно указать имя задания, добавив параметр JobName в такие командлеты, как Invoke-Command и Start-Job.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Входные данные

System.Management.Automation.RemotingJob