Remove-PSBreakpoint

現在のコンソールからブレークポイントを削除します。

構文

Remove-PSBreakpoint [-Id] <Int32[]> [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-Confirm] [-WhatIf] [<CommonParameters>]

説明

Remove-PSBreakpoint コマンドレットは、ブレークポイントを削除します。ブレークポイント オブジェクトまたはブレークポイント ID を入力します。

ブレークポイントを削除すると、ブレークポイント オブジェクトは使用不可になるか、または機能しなくなります。変数にブレークポイント オブジェクトを保存していた場合、参照は存在しますが、ブレークポイントは機能しません。

Remove-PSBreakpoint は、Windows PowerShell スクリプトのデバッグ用に設計された複数のコマンドレットの 1 つです。Windows PowerShell デバッガーの詳細については、「about_Debuggers」を参照してください。

パラメーター

-Breakpoint <Breakpoint[]>

削除するブレークポイントを指定します。ブレークポイント オブジェクトが含まれている変数か、Get-PSBreakpoint コマンドのようにブレークポイント オブジェクトを取得するコマンドを入力します。パイプを使用して、ブレークポイント オブジェクトを Remove-PSBreakpoint に渡すこともできます。

必須

true

位置

1

既定値

なし

パイプライン入力を許可する

true (ByValue)

ワイルドカード文字を許可する

false

-Id <Int32[]>

指定されたブレークポイント ID を持つブレークポイントを削除します。

必須

true

位置

1

既定値

なし

パイプライン入力を許可する

true (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドを実行する前に確認メッセージを表示します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.Management.Automation.Breakpoint

パイプを使用して、ブレークポイント オブジェクトを Remove-PSBreakpoint に渡すことができます。

出力

なし

このコマンドレットは出力を生成しません。

例 1

C:\PS>get-breakpoint | remove-breakpoint

説明
-----------
このコマンドは現在のコンソールのブレークポイントをすべて削除します。





例 2

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | remove-psbreakpoint

説明
-----------
このコマンドは、ブレークポイントを削除します。

最初のコマンドは、Set-PSBreakpoint コマンドレットを使用して、Sample.ps1 スクリプトの Name 変数にブレークポイントを作成します。次に、そのブレークポイント オブジェクトを $b 変数に保存します。

2 番目のコマンドは、Remove-PSBreakpoint コマンドレットを使用して、新しいブレークポイントを削除します。また、パイプライン演算子 (|) を使用して、$b 変数のブレークポイント オブジェクトを Remove-PSBreakpoint コマンドレットに送ります。

このコマンドの結果、スクリプトを実行すると、スクリプトは停止せずに最後まで実行されます。また、Get-PSBreakpoint コマンドレットはこのブレークポイントを返しません。





例 3

C:\PS>remove-psbreakpoint -id 2

説明
-----------
このコマンドは、ブレークポイント ID が 2 であるブレークポイントを削除します。





例 4

C:\PS>function del-psb { get-psbreakpoint | remove-psbreakpoint }

説明
-----------
この単純な関数は現在のコンソールのブレークポイントをすべて削除します。また、Get-PSBreakpoint コマンドレットを使用してブレークポイントを取得します。次に、パイプライン演算子 (|) を使用してブレークポイントを Remove-PSBreakpoint コマンドレットに送信し、ブレークポイントを削除します。

この結果、長いコマンドの代わりに「del-psb」と入力できます。

関数を保存するには、Windows PowerShell プロファイルに追加します。





関連項目

概念

about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Disable-PSBreakpoint
Get-PSCallStack