Поделиться через

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>]

Описание

Командлет 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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

System.ServiceProcess.ServiceController, System.String

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

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

None, System.ServiceProcess.ServiceController

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

Примечания

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

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