Debug-Job

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

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

Syntax

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.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-InstanceId

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

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Job
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-WhatIf

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

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

Girişler

System.Management.Automation.RemotingJob