Restart-Service

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Перезапускает одну или несколько служб.

Синтаксис

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

Описание

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

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

Примеры

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

PS C:\> Restart-Service -Name winmgmt

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

Пример 2. Исключение службы

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

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

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

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

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

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

На практике можно использовать параметр WhatIf для определения эффекта от команды, перед тем как выполнять ее.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayName

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

Тип:String[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Exclude

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-InputObject

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

Тип:ServiceController[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String[]
Aliases:ServiceName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

ServiceController

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

String

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

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

None

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

ServiceController

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

Примечания

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

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