Disable-PSBreakpoint
Отключает точки останова в текущей консоли.
Синтаксис
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Disable-PSBreakpoint
отключает точки останова, что гарантирует, что они не будут поражены при выполнении скрипта. С помощью этого командлета можно отключить все точки останова или указать конкретные точки, задав соответствующие объекты или их идентификаторы.
Технически этот командлет изменяет значение свойства Enabled объекта точки останова на значение False.
Чтобы повторно включить точку останова, используйте Enable-PSBreakpoint
командлет . Точки останова включены по умолчанию при их создании с помощью командлета Set-PSBreakpoint
.
Точка останова — это точка в скрипте, на которой выполнение временно останавливается, чтобы можно было проверить инструкции скрипта. Disable-PSBreakpoint
— это один из нескольких командлетов, предназначенных для отладки скриптов PowerShell. Дополнительные сведения об отладчике PowerShell см. в разделе about_Debuggers.
Примеры
Пример 1. Установка точки останова и ее отключение
Эти команды отключают только что созданную точку останова.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Командлет Set-PSBreakpoint
создает точку останова для переменной $Name
в скрипте Sample.ps1
и сохраняет объект точки останова в переменной $B
. Командлет Disable-PSBreakpoint
отключает новую точку останова. Он использует оператор конвейера (|
) для отправки объекта точки останова в $B
командлет.Disable-PSBreakpoint
В результате выполнения этой команды свойство Enabled объекта точки останова в $B
имеет значение False.
Пример 2. Отключение точки останова
Эта команда отключает точку останова с идентификатором 0.
Disable-PSBreakpoint -Id 0
Пример 3. Create отключенной точки останова
Эта команда создает новую точку останова, которая остается отключенной, пока пользователь ее не включит.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Для отключения точки останова Disable-PSBreakpoint
используется командлет . Значение параметра Точка останова — это Set-PSBreakpoint
команда, которая задает новую точку останова, создает объект точки останова и сохраняет объект в переменной $B
.
Параметры командлета, принимающие в качестве значений объекты, могут принять переменную, которая содержит объект, или команду, которая получает или создает объект. В этом случае, поскольку Set-PSBreakpoint
создает объект точки останова, его можно использовать в качестве значения параметра точки останова .
Пример 4. Отключение всех точек останова в текущей консоли
Эта команда отключает все точки останова в текущей консоли.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Пример 5. Отключение точки останова в пространстве выполнения
В этом примере задание запускается с точкой останова, для которой настроена прерывание при выполнении Set-PSBreakPoint
. Пространство выполнения хранится в переменной и передается команде Get-PSBreakPoint
с параметром Runspace. Выходные 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
командлет.
Type: | Breakpoint[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Отключает точки останова с указанными идентификаторами. Введите идентификаторы или переменную, которая их содержит. Нельзя передать идентификаторы в Disable-PSBreakpoint
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий включенные точки останова. По умолчанию этот командлет не создает выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Runspace
Задает идентификатор объекта Runspace , чтобы можно было взаимодействовать с точками останова в указанном пространстве выполнения.
Этот параметр был добавлен в PowerShell 7.2.
Type: | Runspace |
Aliases: | RunspaceId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Объект точки останова можно передать в этот командлет по конвейеру.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра PassThru этот командлет возвращает объект точки останова, представляющий отключенную точку останова.
Примечания
PowerShell включает следующие псевдонимы для Disable-PSBreakpoint
:
- Для всех платформ.
dbp