次の方法で共有


Remove-PSBreakpoint

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

構文

Breakpoint (既定)

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

Id

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

説明

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

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

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

例 1: すべてのブレークポイントを削除する

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

Get-PSBreakpoint | Remove-PSBreakpoint

例 2: 指定したブレークポイントを削除する

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

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

Set-PSBreakpoint コマンドレットは、$Name スクリプトの Sample.ps1 変数にブレークポイントを作成し、ブレークポイント オブジェクトを $B 変数に保存します。 Remove-PSBreakpoint コマンドレットは、新しいブレークポイントを削除します。 パイプライン演算子 (|) を使用して、$B 変数のブレークポイント オブジェクトを Remove-PSBreakpoint コマンドレットに送信します。

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

例 3: ID でブレークポイントを削除する

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

Remove-PSBreakpoint -Id 2

例 4: 関数を使用してすべてのブレークポイントを削除する

この単純な関数は、現在のセッション内のすべてのブレークポイントを削除します。

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

Get-PSBreakpoint コマンドレットを使用してブレークポイントを取得します。 次に、パイプライン演算子 (|) を使用してブレークポイントを Remove-PSBreakpoint コマンドレットに送信し、それを削除します。

例 5: 実行空間内のブレークポイントを削除する

この例では、ジョブが開始され、Set-PSBreakpoint の実行時にブレークポイントが中断するように設定されています。 実行空間は変数に格納され、Get-PSBreakpoint パラメーターを使用して コマンドに渡されます。 Get-PSBreakpoint の出力は、Remove-PSBreakpoint にパイプ処理され、実行空間内のブレークポイントが削除されます。

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

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Remove-Breakpoint -Runspace $runspace

パラメーター

-Breakpoint

削除するブレークポイントを指定します。 ブレークポイント オブジェクトを含む変数、またはブレークポイント オブジェクトを取得するコマンド (Get-PSBreakpoint コマンドなど) を入力します。 ブレークポイント オブジェクトを Remove-PSBreakpointにパイプすることもできます。

パラメーターのプロパティ

型:

Breakpoint[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Breakpoint
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Id

このコマンドレットがブレークポイントを削除するブレークポイント ID を指定します。

パラメーターのプロパティ

型:

Int32[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Id
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Runspace

指定した実行空間内のブレークポイントと対話できるように、Runspace オブジェクトの ID を指定します。

このパラメーターは PowerShell 7.2 で追加されました。

パラメーターのプロパティ

型:Runspace
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:RunspaceId

パラメーター セット

Id
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Breakpoint

ブレークポイント オブジェクトをこのコマンドレットにパイプできます。

Int32

Runspace

出力

None

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

メモ

PowerShell には、Remove-PSBreakpointの次のエイリアスが含まれています。

  • すべてのプラットフォーム:
    • rbp