Приостанавливает одну или несколько выполняющихся служб.
Синтаксис
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 указывает на необходимость подтверждения пользователем временной остановки для каждой службы.
См. также