Stop-Service (Microsoft.PowerShell.Management)

Stop-Service

Модуль:

Microsoft.PowerShell.Management

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

Синтаксис

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

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

Примеры

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

PS C:\> Stop-Service -Name "sysmonlog"

Эта команда останавливает службу журналов производительности и оповещений (SysmonLog) на локальном компьютере.

Пример 2. Остановите службу, используя отображаемое имя.

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

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

Пример 3. Остановите службу, у которой есть зависимые службы.

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

В этом примере останавливается служба IISAdmin на локальном компьютере. Поскольку остановка этой службы также останавливает службы, зависящие от службы IISAdmin, лучше всего предшествовать Stop-Service команде, в которой перечислены службы, зависящие от службы IISAdmin.

Первая команда перечисляет службы, зависящие от IISAdmin. Он использует Get-Service для получения объекта, представляющего службу IISAdmin. Оператор конвейера (|) передает результат командлету Format-List. Команда использует параметр Property Format-List для вывода списка только свойств Name и DependentServices службы.

Вторая команда останавливает службу IISAdmin. Параметр Force необходим для остановки службы, у которой есть зависимые службы. Команда использует параметр Confirm для запроса подтверждения от пользователя перед остановкой каждой службы.

Параметры

-Confirm

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

Тип :

SwitchParameter

Псевдонимы:

cf

Позиция:

Именованный

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

False

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

False

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

False

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

False

-DisplayName

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

Тип :

String[]

Позиция:

Именованный

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

None

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

True

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

False

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

True

-Exclude

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

Тип :

String[]

Позиция:

Именованный

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

None

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

False

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

False

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

True

-Force

Заставляет командлет остановить службу, даже если у этой службы есть зависимые службы.

Тип :

SwitchParameter

Позиция:

Именованный

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

None

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

False

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

False

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

False

-Include

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

Тип :

String[]

Позиция:

Именованный

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

None

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

False

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

False

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

True

-InputObject

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

Тип :

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

Позиция:

0

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

None

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

True

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

True

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

False

-Name

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

Тип :

String[]

Псевдонимы:

ServiceName

Позиция:

0

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

None

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

True

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

True

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

True

-NoWait

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

Тип :

SwitchParameter

Позиция:

Именованный

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

None

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

False

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

False

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

False

-PassThru

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

Тип :

SwitchParameter

Позиция:

Именованный

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

None

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

False

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

False

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

False

-WhatIf

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

Тип :

SwitchParameter

Псевдонимы:

wi

Позиция:

Именованный

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

False

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

False

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

False

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

False

Входы

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

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

Строка

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

Выходы

Нет

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

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

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

Примечания

PowerShell включает следующие псевдонимы для Stop-Service:

• Windows:

  spsv

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

Stop-Service может управлять службами только в том случае, если текущий пользователь имеет на это разрешение. Если команда работает неправильно, возможно, у вас нет необходимых разрешений.

Чтобы найти имена служб и отображаемые имена служб в вашей системе, введите Get-Service. Имена служб отображаются в столбце Имя, а отображаемые имена — в столбце DisplayName.