Get-PSBreakpoint

Modül:
Microsoft.PowerShell.Utility Module

Geçerli oturumda ayarlanan kesme noktalarını alır.

Syntax

Line (Varsayılan) 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Runspace <Runspace>]
    [<CommonParameters>]

Command 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Command <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Variable 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Variable <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Type 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Type] <BreakpointType[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Id 

Get-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Description

Get-PSBreakpoint cmdlet'i, geçerli oturumda ayarlanan kesme noktalarını alır. Belirli kesme noktalarını almak için cmdlet parametrelerini kullanabilirsiniz.

Kesme noktası, komut veya betikte, yönergeleri inceleyebilmeniz için yürütmenin geçici olarak durduğu bir noktadır. Get-PSBreakpoint, PowerShell betiklerinde ve komutlarında 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: Tüm betikler ve işlevler için tüm kesme noktalarını alma

Bu komut, geçerli oturumdaki tüm betiklerde ve işlevlerde ayarlanan tüm kesme noktalarını alır.

Get-PSBreakpoint

Örnek 2: ID ile kesme noktalarını alma

Bu komut, kesme noktası ID'si 2 olan kesme noktasını getirir.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Örnek 3: Bir kimliği 'Get-PSBreakpoint' ile yönlendirme

Bu komutlar, bir kesme noktası kimliğini Get-PSBreakpoint'a yönlendirerek kesme noktası elde etme yöntemini gösterir.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Set-PSBreakpoint cmdlet'i, Sample.ps1 betiğindeki Increment işlevinde bir kesme noktası oluşturur ve kesme noktası nesnesini $B değişkenine kaydeder. değişkenindeki kesme noktası nesnesinin $B özelliği, kesme noktası bilgilerini görüntülemek için Get-PSBreakpoint cmdlet'ine yöneltilir.

Örnek 4: Belirtilen betik dosyalarındaki kesme noktalarını alma

Bu komut, Sample.ps1 ve SupportScript.ps1 dosyalarındaki tüm kesme noktalarını alır.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Bu komut, diğer betiklerde veya oturumdaki işlevlerde ayarlanabilecek diğer kesme noktalarını almaz.

Örnek 5: Belirtilen cmdlet'lerde kesme noktalarını alma

Bu komut, Read-Host dosyasındaki Write-Host veya Sample.ps1 komutlarında ayarlanan tüm Komut kesme noktalarını alır.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Örnek 6: Belirtilen dosyada Komut kesme noktalarını alma

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Bu komut, Sample.ps1 dosyasındaki tüm Komut kesme noktalarını alır.

Örnek 7: Değişkene göre kesme noktalarını alma

Bu komut, geçerli oturumdaki $Index ve $Swap değişkenlerinde ayarlanan kesme noktalarını alır.

Get-PSBreakpoint -Variable "Index, Swap"

Örnek 8: Dosyadaki tüm Satır ve Değişken kesme noktalarını alma

Bu komut, Sample.ps1 betiğindeki tüm satır ve değişken kesme noktalarını alır.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Örnek 9: Belirli bir çalışma alanında ayarlanan kesme noktalarını elde etme

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. Daha sonra $breakpoint değişkenindeki kesme noktasını inceleyebilirsiniz.

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakpoint -Runspace $runspace

Parametreler

-Command

Belirtilen komut adlarında ayarlanan bir komut kesme noktası dizisini belirtir. Cmdlet veya işlev adı gibi komut adlarını girin.

Parametre özellikleri

Tür:

String[]

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

Parametre kümeleri

Command
Position:Named
Zorunlu:True
İş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

Bu cmdlet'in aldığı kesme noktası kimliklerini belirtir. Kimlikleri virgülle ayrılmış bir listeye girin. Kesme noktası kimliklerini Get-PSBreakpoint'a da yöneltebilirsiniz.

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

-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

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

-Script

Kesme noktalarını içeren scriptlerin bir dizisini belirtir. Bir veya daha fazla betik dosyasının yolunu (isteğe bağlı) ve adlarını girin. Yolu belirtmezseniz, varsayılan konum geçerli dizindir.

Parametre özellikleri

Tür:

String[]

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

Parametre kümeleri

Script
Position:Named
Zorunlu:False
İş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
Variable
Position:Named
Zorunlu:False
İş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
Command
Position:Named
Zorunlu:False
İş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
Type
Position:Named
Zorunlu:False
İş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

-Type

Bu cmdlet'in aldığı kesme noktası türleri dizisini belirtir. Bir veya daha fazla tür girin. Bu parametre için kabul edilebilir değerler şunlardır:

  • Satır
  • Komut
  • Değişken

Kesme noktası türlerini Get-PSBreakpoint'e de yönlendirebilirsiniz.

Parametre özellikleri

Tür:

BreakpointType[]

Default value:None
Kabul edilen değerler:Line, Variable, Command
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Type
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

-Variable

Belirtilen değişken adlarında ayarlanan değişken kesme noktaları dizisini belirtir. Değişken adlarını dolar işareti olmadan girin.

Parametre özellikleri

Tür:

String[]

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

Parametre kümeleri

Variable
Position:Named
Zorunlu:True
İş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

Int32

Kırılma noktası kimliklerini bu cmdlet'e yönlendirebilirsiniz.

BreakpointType

Kesme noktası türlerini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Bu cmdlet, oturumdaki kesme noktalarını temsil eden nesneleri döndürür.

Notlar

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

  • Tüm platformlar:
    • gbp