Remove-PSBreakpoint
現在のコンソールからブレークポイントを削除します。
構文
Remove-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSBreakpoint
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-PSBreakpoint コマンドレットは、ブレークポイントを削除します。 ブレークポイント オブジェクトまたはブレークポイント ID を入力します。
ブレークポイントを削除すると、ブレークポイント オブジェクトは使用できなくなり、機能しなくなります。 ブレークポイント オブジェクトを変数に保存した場合、参照は引き続き存在しますが、ブレークポイントは機能しません。
Remove-PSBreakpoint は、Windows PowerShell スクリプトのデバッグ用に設計されたいくつかのコマンドレットの 1 つです。 Windows PowerShell デバッガーの詳細については、「about_Debuggers」を参照してください。
例
例 1: すべてのブレークポイントを削除する
PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint
このコマンドは、現在のコンソール内のすべてのブレークポイントを削除します。
例 2: 指定したブレークポイントを削除する
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint
このコマンドはブレークポイントを削除します。
最初のコマンドでは、Set-PSBreakpoint コマンドレットを使用して、Sample.ps1 スクリプトの Name 変数にブレークポイントを作成します。 次に、ブレークポイント オブジェクトを $B 変数に保存します。
2 番目のコマンドでは、 Remove-PSBreakpoint コマンドレットを使用して新しいブレークポイントを削除します。 パイプライン演算子 (|) を使用して、$B 変数のブレークポイント オブジェクトを Remove-PSBreakpoint コマンドレットに送信します。
このコマンドの結果として、スクリプトを実行すると、停止せずに完了まで実行されます。 また、 Get-PSBreakpoint コマンドレットはこのブレークポイントを返しません。
例 3: ID でブレークポイントを削除する
PS C:\> Remove-PSBreakpoint -Id 2
このコマンドは、ブレークポイント ID 2 のブレークポイントを削除します。
例 4: 関数を使用してすべてのブレークポイントを削除する
PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }
この単純な関数は、現在のコンソール内のすべてのブレークポイントを削除します。 Get-PSBreakpoint コマンドレットを使用してブレークポイントを取得します。 次に、パイプライン演算子 (|) を使用してブレークポイントを Remove-PSBreakpoint コマンドレットに送信し、ブレークポイントを削除します。
その結果、長いコマンドの代わりに del-psb
と入力できます。
関数を保存するには、Windows PowerShell プロファイルに追加します。
パラメーター
-Breakpoint
削除するブレークポイントを指定します。 ブレークポイント オブジェクトを含む変数、またはブレークポイント オブジェクトを取得するコマンド ( Get-PSBreakpoint コマンドなど) を入力します。 ブレークポイント オブジェクトを Remove-PSBreakpoint にパイプ処理することもできます。
型: | Breakpoint[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
このコマンドレットがブレークポイントを削除するブレークポイント ID を指定します。
型: | Int32[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
ブレークポイント オブジェクトを Remove-PSBreakpoint にパイプできます。
出力
None
コマンドレットは出力を生成しません。