Suspend-Service (Microsoft.PowerShell.Management)

Suspend-Service

Модуль:

Microsoft.PowerShell.Management

Приостанавливает (приостанавливает) одну или несколько запущенных служб.

Синтаксис

Suspend-Service
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Suspend-Service
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Suspend-Service
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет Suspend-Service отправляет сообщение о приостановке контроллеру служб Windows для каждой из указанных служб. Во время приостановки служба продолжает работать, но ее действие приостанавливается до возобновления, например с помощью командлета Resume-Service. Вы можете указать службы по их именам или отображаемым именам или использовать параметр InputObject для передачи объекта службы, представляющего службы, которые вы хотите приостановить.

Примеры

Пример 1. Приостановка службы

PS C:\> Suspend-Service -DisplayName "Telnet"

Эта команда приостанавливает работу службы Telnet (Tlntsvr) на локальном компьютере.

Пример 2. Отображение того, что произойдет, если вы приостановите службы.

PS C:\> Suspend-Service -Name lanman* -WhatIf

Эта команда сообщает, что произойдет, если вы приостановите работу служб, имя которых начинается с lanman. Чтобы приостановить службы, повторно запустите команду без параметра WhatIf.

Пример 3. Получение и приостановка службы

PS C:\> Get-Service schedule | Suspend-Service

Эта команда использует командлет Get-Service для получения объекта, представляющего службу планировщика задач (расписание) на компьютере. Оператор конвейера (|) передает результат в Suspend-Service, который приостанавливает службу.

Пример 4. Приостановить все службы, которые можно приостановить.

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Эта команда приостанавливает все службы на компьютере, которые можно приостановить. Он использует Get-Service для получения объектов, представляющих службы на компьютере. Оператор конвейера передает результаты командлету Where-Object, который выбирает только те службы, которые имеют значение $True для свойства CanPauseAndContinue. . Другой оператор конвейера передает результаты в Suspend-Service. Параметр Confirm запрашивает подтверждение перед приостановкой каждой службы.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :

SwitchParameter

Псевдонимы:

cf

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-DisplayName

Указывает отображаемые имена служб, которые необходимо приостановить. Допускаются подстановочные знаки.

Тип :

String[]

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

True

-Exclude

Указывает службы, которые следует исключить из указанных служб. Значение этого параметра определяет параметр Name. Введите элемент имени или шаблон, например «s*». Допускаются подстановочные знаки.

Тип :

String[]

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

True

-Include

Указывает службы для приостановки. Значение этого параметра определяет параметр Name. Введите элемент имени или шаблон, например «s*». Допускаются подстановочные знаки.

Тип :

String[]

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

True

-InputObject

Указывает объекты ServiceController, которые представляют приостанавливаемые службы. Введите переменную, содержащую объекты, или введите команду или выражение, позволяющее получить объекты.

Тип :

Сервисконтроллер[]

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Name

Указывает имена приостанавливаемых служб. Допускаются подстановочные знаки.

Имя параметра не является обязательным. Вы можете использовать Name или его псевдоним ServiceName или опустить имя параметра.

Тип :

String[]

Псевдонимы:

ServiceName

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

True

-PassThru

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

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-WhatIf

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

Тип :

SwitchParameter

Псевдонимы:

wi

Позиция:

Именованный

Значение по умолчанию:

False

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

Сервисконтроллер

Вы можете передать объект службы этому командлету.

Строка

В этот командлет можно передать строку, содержащую имя службы.

Выходы

Нет

По умолчанию этот командлет не возвращает никаких результатов.

Сервисконтроллер

При использовании параметра PassThru этот командлет возвращает объект ServiceController, представляющий службу.

Примечания

Этот командлет доступен только на платформах Windows.

• Suspend-Service может управлять службами только в том случае, если текущий пользователь имеет на это разрешение. Если команда работает неправильно, возможно, у вас нет необходимых разрешений.
• Suspend-Service может приостанавливать только те службы, которые поддерживают приостановку и возобновление. Чтобы определить, можно ли приостановить конкретную службу, используйте командлет Get-Service вместе со свойством CanPauseAndContinue. Например, Get-Service wmi | Имя списка форматов, CanPauseAndContinue. Чтобы найти все службы на компьютере, которые можно приостановить, введите Get-Service | Где-Объект {$_.CanPauseAndContinue -eq $true.
• Чтобы найти имена служб и отображаемые имена служб в вашей системе, введите Get-Service. Имена служб отображаются в столбце Имя, а отображаемые имена — в столбце DisplayName.