次の方法で共有


Disable-PSBreakpoint

現在のコンソールのブレークポイントを無効にします。

構文

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

説明

Disable-PSBreakpoint コマンドレットはブレークポイントを無効にし、スクリプトの実行時にヒットしないことを保証します。 これを使用してすべてのブレークポイントを無効にすることも、ブレークポイント オブジェクトまたはブレークポイント ID を送信してブレークポイントを指定することもできます。

技術的には、このコマンドレットはブレークポイント オブジェクトの Enabled プロパティの値を False に変更します。 ブレークポイントを再度有効にするには、Enable-PSBreakpoint コマンドレットを使用します。 ブレークポイントは、Set-PSBreakpoint コマンドレットを使用してブレークポイントを作成するときに既定で有効になります。

ブレークポイントは、スクリプト内の命令を調べることができるように、実行が一時的に停止するスクリプト内のポイントです。 Disable-PSBreakpoint は、PowerShell スクリプトのデバッグ用に設計されたいくつかのコマンドレットの 1 つです。 PowerShell デバッガーの詳細については、「about_Debuggers」を参照してください。

例 1: ブレークポイントを設定して無効にする

これらのコマンドは、新しく作成されたブレークポイントを無効にします。

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

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

このコマンドの結果として、$B のブレークポイント オブジェクトの Enabled プロパティの値は False

例 2: ブレークポイントを無効にする

このコマンドは、ブレークポイント ID が 0 のブレークポイントを無効にします。

Disable-PSBreakpoint -Id 0

例 3: 無効なブレークポイントを作成する

このコマンドは、有効になるまで無効になっている新しいブレークポイントを作成します。

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Disable-PSBreakpoint コマンドレットを使用してブレークポイントを無効にします。 ブレークポイント パラメーターの値は、新しいブレークポイントを設定し、ブレークポイント オブジェクトを生成し、オブジェクトを $B 変数に保存する Set-PSBreakpoint コマンドです。

オブジェクトを値として受け取るコマンドレット パラメーターは、オブジェクトを含む変数、またはオブジェクトを取得または生成するコマンドを受け取ることができます。 この場合、Set-PSBreakpoint はブレークポイント オブジェクトを生成するため、ブレークポイント パラメーターの値として使用できます。

例 4: 現在のコンソールのすべてのブレークポイントを無効にする

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

例 5: 実行空間でブレークポイントを無効にする

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

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

パラメーター

-Breakpoint

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

型:Breakpoint[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

指定したブレークポイント ID を持つブレークポイントを無効にします。 ID または ID を含む変数を入力します。 Disable-PSBreakpointに ID をパイプすることはできません。

型:Int32[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

有効なブレークポイントを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Runspace

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

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

型:Runspace
Aliases:RunspaceId
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Breakpoint

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

出力

None

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

Breakpoint

PassThru パラメーターを使用すると、このコマンドレットは無効なブレークポイントを表すブレークポイント オブジェクトを返します。

メモ

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

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