Disable-PSBreakpoint

Ссылка

Модуль:: Microsoft.PowerShell.Utility

Отключает точки останова в текущей консоли.

Синтаксис

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

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

Описание

Командлет Disable-PSBreakpoint отключает точки останова, что гарантирует, что они не попадут при выполнении скрипта. С помощью этого командлета можно отключить все точки останова или указать конкретные точки, задав соответствующие объекты или их идентификаторы.

Технически этот командлет изменяет значение свойства Enabled объекта точки останова на значение False. Для повторного включения точки останова используется командлет Enable-PSBreakpoint. Точки останова по умолчанию включаются при их создании с помощью командлета Set-PSBreakpoint.

Точка останова — это точка в скрипте, на которой выполнение временно останавливается, чтобы можно было проверить инструкции скрипта. Disable-PSBreakpoint — это один из нескольких командлетов, предназначенных для отладки сценариев PowerShell. Дополнительные сведения об отладчике PowerShell см. в разделе about_Debuggers.

Примеры

Пример 1. Установка точки останова и ее отключение

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Эти команды отключают только что созданную точку останова.

Первая команда использует командлет Set-PSBreakpoint для создания точки останова в переменной Name в скрипте Sample.ps1. Затем она сохраняет объект точки останова в переменной $b.

Вторая команда использует командлет Disable-PSBreakpoint для отключения новой точки останова. Он использует оператор конвейера (|) для отправки объекта точки останова в $B командлету Disable-PSBreakpoint .

В результате выполнения этой команды значение свойства Enabled объекта точки останова в $B равно False.

Пример 2. Отключение точки останова

PS C:\> Disable-PSBreakpoint -Id 0

Эта команда отключает точку останова с идентификатором 0.

Пример 3. Create отключенной точки останова

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Эта команда создает новую точку останова, которая остается отключенной, пока пользователь ее не включит.

Для отключения точки останова используется командлет Disable-PSBreakpoint . Значение параметра Точка останова — это Set-PSBreakpoint команда, которая задает новую точку останова, создает объект точки останова и сохраняет объект в переменной $B.

Параметры командлета, принимающие в качестве значений объекты, могут принять переменную, которая содержит объект, или команду, которая получает или создает объект. В этом случае, так как Set-PSBreakpoint создает объект точки останова, его можно использовать в качестве значения параметра Точки останова .

Вторая команда отображает объект точки останова в значении переменной $B.

Пример 4. Отключение всех точек останова в текущей консоли

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Эта команда отключает все точки останова в текущей консоли. Эту команду можно сократить следующим образом: "gbp | dbp".

Параметры

-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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

Breakpoint

Объект точки останова можно передать по конвейеру в Disable-PSBreakpoint.

Выходные данные

None or System.Management.Automation.Breakpoint

При использовании параметра PassThruФункция Disable-PSBreakpoint возвращает объект , представляющий отключенную точку останова. В противном случае командлет не формирует никаких выходных данных.