Suspend-Service

Модуль:

Microsoft.PowerShell.Management Module

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

Синтаксис

InputObject (По умолчанию)

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

Default

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

DisplayName

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

Описание

Командлет 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

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

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DisplayName

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

DisplayName

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Exclude

Указывает службы, которые будут опущены из указанных служб. Значение этого параметра квалифифициирует параметр Name. Введите элемент имени или шаблон, например "s*". Разрешено использование подстановочных символов.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Include

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметров

Тип:	ServiceController[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

InputObject

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

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

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False
Aliases:	Название сервиса

Наборы параметров

Default

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-PassThru

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

Свойства параметров

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

ServiceController

Объект сервиса можно передать в этот командлет в качестве параметра.

String

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

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

None

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

ServiceController

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

Примечания

• Suspend-Service может управлять службами только в том случае, если у текущего пользователя есть разрешение на это. Если команда не работает правильно, возможно, у вас нет необходимых разрешений.
• Suspend-Service может приостановить только службы, поддерживающие приостановку и возобновление работы. Чтобы определить, можно ли приостановить определенную службу, используйте командлет Get-Service вместе со свойством CanPauseAndContinue. Например: Get-Service wmi | Format-List Name, CanPauseAndContinue. Чтобы найти все службы на компьютере, который можно приостановить, введите Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
• Чтобы найти имена служб и отображаемые имена служб в системе, введите Get-Service. Названия служб появляются в столбце Name, а отображаемые имена появляются в столбце DisplayName.

Связанные ссылки

• Get-Service
• Новая услуга
• Restart-Service
• Сервис резюме
• Set-Service
• Start-Service
• Остановить службу