Disable-PSBreakpoint

Modül:
Microsoft.PowerShell.Utility Module

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

Syntax

Breakpoint (Varsayılan) 

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

Id 

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

Description

Disable-PSBreakpoint cmdlet'i 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 Enable-PSBreakpoint cmdlet'ini kullanın. Kesme noktaları, Set-PSBreakpoint cmdlet'ini 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

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

Bu komutun sonucu olarak, kesme noktası nesnesinin $B özelliğinin değeri False .

Ö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 Disable-PSBreakpoint cmdlet'ini kullanır. Kesme Noktası parametresinin değeri, yeni bir kesme noktası ayarlayan, kesme noktası nesnesi oluşturan ve nesneyi Set-PSBreakpoint değişkenine kaydeden bir $B komutudur.

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 bir 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 Set-PSBreakpoint çalıştırıldığında duracak şekilde bir kesme noktası ayarlanır. Runspace bir değişkende depolanır ve Get-PSBreakpoint parametresiyle komutuna geçirilir. Get-PSBreakpoint çıkışı, çalışma alanında kesme noktasını devre dışı bırakmak için Disable-PSBreakpoint yöneltilir.

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 Get-PSBreakpoint komutu gibi kesme noktası nesnelerini alan bir komut girin. Kesme noktası nesnelerini Disable-PSBreakpoint cmdlet'ine de yöneltebilirsiniz.

Parametre özellikleri

Tür:

Breakpoint[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Breakpoint
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 Disable-PSBreakpointkanala alamazsınız.

Parametre özellikleri

Tür:

Int32[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Id
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-PassThru

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Runspace

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

Bu parametre PowerShell 7.2'ye eklendi.

Parametre özellikleri

Tür:Runspace
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:RunspaceId

Parametre kümeleri

Id
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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, Disable-PSBreakpointiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:
    • dbp