Останавливает одну или несколько выполняющихся служб.
Синтаксис
Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Stop-Service отсылает сообщение об остановке диспетчеру служб Windows для каждой указанной службы. Службы можно задавать с помощью их имен или отображаемых имен. Кроме того, можно с помощью параметра InputObject передавать объекты, представляющие останавливаемые службы.
Параметры
-DisplayName <string[]>
Задает отображаемые имена останавливаемых служб. Подстановочные знаки разрешены.
|
Обязательно? |
true |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Exclude <string[]>
Исключает указанные службы. Значение данного параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Force
Позволяет командлету остановить службу, даже если у нее есть зависимые службы.
|
Обязательно? |
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. Можно передать объект службы или строку, содержащую имя службы, по конвейеру командлету Stop-Service. |
|
Выходные данные |
Нет или System.ServiceProcess.ServiceController Если задан параметр PassThru, командлет Stop-Service формирует объект System.ServiceProcess.ServiceController, представляющий службу. В противном случае этот командлет не формирует никаких выходных данных. |
Примечания
Командлет Stop-Service также можно вызывать с помощью встроенного псевдонима "spsv". Дополнительные сведения см. в разделе About_Aliases.
Командлет Stop-Service может использоваться для управления службами, только если у текущего пользователя есть на это разрешение. Некорректная работа команды может быть обусловлена отсутствием требуемых разрешений.
Чтобы извлечь имена служб и отображаемые имена служб на текущем компьютере, введите команду "Get-Service". Имена служб содержатся в столбце Name, а отображаемые имена — в столбце DisplayName.
Пример 1
C:\PS>stop-service sysmonlog Описание ----------- Эта команда останавливает службу "Журналы и оповещения производительности" (SysmonLog) на локальном компьютере.
Пример 2
C:\PS>get-service -displayname telnet | stop-service Описание ----------- Эта команда останавливает службу Telnet на локальном компьютере. Для извлечения объекта, представляющего службу Telnet, используется командлет Get-Service. Оператор конвейера (|) пересылает объект командлету Stop-Service, который останавливает службу.
Пример 3
C:\PS>get-service iisadmin | format-list -property name, dependentservices C:PS>stop-service iisadmin -force -confirm Описание ----------- Команда Stop-Service останавливает службу IISAdmin на локальном компьютере. Поскольку остановка данной службы влечет за собой остановку служб, зависимых от IISAdmin, перед выполнением команды Stop-Service рекомендуется ввести команду для вывода списка служб, зависимых от IISAdmin. Первая команда отображает список всех служб, зависимых от IISAdmin. Для извлечения объекта, представляющего службу IISAdmin, используется командлет Get-Service. Оператор конвейера (|) передает результат командлету Format-List. Для вывода на экран только значений свойств Name и DependentServices службы в команде Format-List используется параметр Property. Вторая команда останавливает работу службы IISAdmin. Параметр Force необходим для остановки служб, имеющих связанные с ними зависимые службы. Для запроса подтверждения пользователя на остановку каждой службы используется параметр Confirm.
См. также