Останавливает, а затем запускает заново одну или несколько служб.

Синтаксис

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

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

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

Описание

Командлет Restart-Service передает сообщение об остановке каждой указанной службы программе Windows Service Controller. Если служба уже была остановлена ранее, то она перезапускается без сообщения об ошибке. Службы можно задавать с помощью их служебных имен или отображаемых имен. Также можно использовать параметр InputObject и передавать объекты, представляющие перезапускаемые службы.

Параметры

-DisplayName <string[]>

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

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

true

Позиция?

named

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

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

false

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

false

-Exclude <string[]>

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

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

false

Позиция?

named

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

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

false

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

false

-Force

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

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

false

Позиция?

named

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

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

false

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

false

-Include <string[]>

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

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

false

Позиция?

named

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

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

false

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

false

-InputObject <ServiceController[]>

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

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

false

Позиция?

named

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

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

true (ByValue)

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

false

-Name <string[]>

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

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

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

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

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

Нет или System.ServiceProcess.ServiceController

Если задан параметр PassThru, командлет Restart-Service создает объект System.ServiceProcess.ServiceController, представляющий перезапущенную службу. В противном случае этот командлет не формирует никаких выходных данных.

Примечания

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

Чтобы извлечь имена служб и отображаемые имена служб на текущем компьютере, введите команду "Get-Service". Имена служб содержатся в столбце "Name", а отображаемые имена — в столбце "DisplayName".

Пример 1

C:\PS>restart-service wmi

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






Пример 2

C:\PS>restart-service -displayname net* -exclude "net logon"

Описание
-----------
Эта команда перезапускает все службы, отображаемые имена которых начинаются с "Net", за исключением службы "Net Logon".






Пример 3

C:\PS>get-service net* | where-object {$_.Status -eq "Stopped"} | restart-service

Описание
-----------
Эта команда запускает все остановленные сетевые службы компьютера.

Для извлечения всех объектов, представляющих службы компьютера с именами, начинающимися с "net", используется командлет Get-Service. (Необязательное имя параметра Name опускается.) Оператор конвейера (|) пересылает объекты служб командлету Where-Object, который выбирает только службы с состоянием "Stopped" (остановлена). Следующий оператор конвейера пересылает выбранные службы командлету Restart-Service. На практике, чтобы узнать о последствиях выполнения команды до ее использования, используется параметр WhatIf.






См. также




Содержание