Disable-PSBreakpoint

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

Geçerli konsoldaki kesme noktalarını devre dışı bırakır.

Sözdizimi

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

cmdlet'i Disable-PSBreakpoint kesme noktalarını devre dışı bırakır ve betik çalıştırıldığında isabet almamalarını sağlar. Tüm kesme noktalarını devre dışı bırakmak için kullanabilir veya kesme noktası nesneleri veya kesme noktası kimlikleri göndererek kesme noktaları belirtebilirsiniz.

Teknik olarak, bu cmdlet bir kesme noktası nesnesinin Enabled özelliğinin değerini False olarak değiştirir. Kesme noktasını yeniden etkinleştirmek için cmdlet'ini Enable-PSBreakpoint kullanın. Kesme noktaları, cmdlet'ini Set-PSBreakpoint kullanarak oluşturduğunuzda varsayılan olarak etkinleştirilir.

Kesme noktası, betikteki yönergeleri inceleyebilmeniz için yürütmenin geçici olarak durduğu bir noktadır. Disable-PSBreakpoint , PowerShell betiklerinde hata ayıklamak için tasarlanmış çeşitli cmdlet'lerden biridir. PowerShell hata ayıklayıcısı hakkında daha fazla bilgi için bkz . about_Debuggers.

Örnekler

Örnek 1: Kesme noktası ayarlama ve devre dışı bırakma

Bu komutlar yeni oluşturulan kesme noktasını devre dışı bırakır.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Cmdlet betikteki Set-PSBreakpoint Sample.ps1 değişkende $Name bir kesme noktası oluşturur ve kesme noktası nesnesini değişkene $B kaydeder. cmdlet'i Disable-PSBreakpoint yeni kesme noktasını devre dışı bırakır. kesme noktası nesnesini cmdlet'ine $B göndermek için Disable-PSBreakpoint bir işlem hattı işleci (|) kullanır.

Bu komutun sonucu olarak içindeki kesme noktası nesnesinin Enabled özelliğinin değeri False'tur. $B

Örnek 2: Kesme noktasını devre dışı bırakma

Bu komut kesme noktası kimliği 0 olan kesme noktasını devre dışı bırakır.

Disable-PSBreakpoint -Id 0

Örnek 3: Devre dışı kesme noktası oluşturma

Bu komut, siz etkinleştirene kadar devre dışı bırakılan yeni bir kesme noktası oluşturur.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Kesme noktasını devre dışı bırakmak için cmdlet'ini kullanır Disable-PSBreakpoint . Kesme noktası parametresinin değeri, yeni bir kesme noktası ayarlayan, kesme noktası nesnesi oluşturan ve nesneyi değişkene $B kaydeden bir Set-PSBreakpoint komutdur.

Nesneleri değerleri olarak alan cmdlet parametreleri, nesneyi içeren bir değişkeni veya nesneyi alan veya oluşturan bir komutu kabul edebilir. Bu durumda, Set-PSBreakpoint kesme noktası nesnesi oluşturduğundan Kesme Noktası parametresinin değeri olarak kullanılabilir.

Örnek 4: Geçerli konsoldaki tüm kesme noktalarını devre dışı bırakma

Bu komut geçerli konsoldaki tüm kesme noktalarını devre dışı bırakır.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Örnek 5: Çalışma alanında kesme noktasını devre dışı bırakma

Bu örnekte, bir iş başlatılır ve bir kesme noktası çalıştırıldığında Set-PSBreakPoint kesecek şekilde ayarlanır. Runspace bir değişkende depolanır ve Runspace parametresiyle komutuna geçirilirGet-PSBreakPoint. çıkışı Get-PSBreakPoint , çalışma alanında kesme noktasını devre dışı bırakmak için öğesine yöneltilir Disable-PSBreakpoint .

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

Parametreler

-Breakpoint

Devre dışı bırakacak kesme noktalarını belirtir. Kesme noktası nesneleri içeren bir değişken veya komut gibi kesme noktası nesnelerini alan bir Get-PSBreakpoint komut girin. Kesme noktası nesnelerini cmdlet'ine Disable-PSBreakpoint de yöneltebilirsiniz.

Tür:Breakpoint[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
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

Belirtilen kesme noktası kimlikleriyle kesme noktalarını devre dışı bırakır. Kimlikleri veya kimlikleri içeren bir değişken girin. Kimlikleri adresine yöneltemezsiniz Disable-PSBreakpoint.

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

-PassThru

Etkin kesme noktalarını temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

-Runspace

Belirtilen çalışma alanında kesme noktalarıyla etkileşim kurabilmeniz için Runspace nesnesinin kimliğini belirtir.

Bu parametre PowerShell 7.2'ye eklendi.

Tür:Runspace
Diğer adlar:RunspaceId
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
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

Breakpoint

Kesme noktası nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

Breakpoint

PassThru parametresini kullandığınızda, bu cmdlet devre dışı bırakılan kesme noktasını temsil eden bir kesme noktası nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Disable-PSBreakpointiçerir:

  • Tüm platformlar:
    • dbp