Debug-Job

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Çalışan bir arka plan veya uzak işin hatalarını ayıklar.

Sözdizimi

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

cmdlet'i Debug-Job , işler içinde çalışan betiklerde hata ayıklamanıza olanak tanır. Cmdlet, uzak oturumlarda çalışan PowerShell İş Akışı işlerinde, arka plan işlerinde ve işlerde hata ayıklamak için tasarlanmıştır. Debug-Job çalışan bir iş nesnesini, adını, kimliğini veya örnek kimliğini giriş olarak kabul eder ve çalıştırılan betikte bir hata ayıklama oturumu başlatır. Hata ayıklayıcısı quit komutu işi ve çalışan betiği durdurur. exit komutu hata ayıklayıcıyı ayırır ve işin çalışmaya devam etmesine izin verir.

Örnekler

Örnek 1: İş kimliğine göre bir işin hatalarını ayıklama

Bu komut, 3 kimlikli çalışan bir işe girer.

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"

Parametreler

-BreakAll

Hata ayıklayıcı eklendiğinde geçerli konumda hemen kesmenizi sağlar.

Bu parametre PowerShell 7.2'ye eklendi.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Id

Çalışan bir işin kimlik numarasını belirtir. İşin kimlik numarasını almak için cmdlet'ini Get-Job çalıştırın.

Tür:Int32
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InstanceId

Çalışan bir işin örnek kimliği GUID'sini belirtir.

Tür:Guid
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Job

Çalışan bir iş nesnesi belirtir. Bu parametreyi kullanmanın en basit yolu, bir değişkende hata ayıklamak istediğiniz çalışan işi döndüren bir Get-Job komutun sonuçlarını kaydetmek ve ardından değişkeni bu parametrenin değeri olarak belirtmektir.

Tür:Job
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

İşin kolay adına göre bir iş belirtir. Bir işi başlattığınızda, ve Start-Jobgibi Invoke-Command cmdlet'lerde JobName parametresini ekleyerek bir iş adı belirtebilirsiniz.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

System.Management.Automation.RemotingJob