Restart-Service
Останавливает, а затем запускает заново одну или несколько служб.
Синтаксис
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.
См. также
Концепции
Start-Service
Stop-Service
Suspend-Service
Resume-Service
New-Service
Get-Service
Set-Service