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

Синтаксис

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

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

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

Описание

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

Параметры

-DisplayName <string[]>

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

Обязательно?

true

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

-Exclude <string[]>

Исключает указанные службы. Значение данного параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Подстановочные знаки разрешены.

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

-Include <string[]>

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

-InputObject <ServiceController[]>

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

true (ByValue)

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

false

-Name <string[]>

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

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

Обязательно?

true

Позиция?

1

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

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

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

false

-PassThru

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

-Confirm

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

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

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

System.ServiceProcess.ServiceController или System.String.

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

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

Нет или System.ServiceProcess.ServiceController

Если задан параметр PassThru, командлет Suspend-Service формирует объект System.ServiceProcess.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.

Пример 1

C:\PS>suspend-service -displayname "Telnet"

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






Пример 2

C:\PS>suspend-service -name lanman* -whatif

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






Пример 3

C:\PS>get-service schedule | suspend-service

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






Пример 4

C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm

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






См. также