Restart-Service

Модуль:

Microsoft.PowerShell.Management Module

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

Синтаксис

InputObject (по умолчанию)

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

Default

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

DisplayName

Restart-Service
    -DisplayName <String[]>
    [-Force]
    [-PassThru]
    [-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.

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

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

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

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

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

Параметры

-Confirm

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DisplayName

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

DisplayName

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Exclude

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Force

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Include

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputObject

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

Свойства параметра

Тип:	ServiceController[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

InputObject

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False
Aliases:	Название сервиса

Наборы параметров

Default

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-PassThru

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

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметра

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

ServiceController

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

String

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

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

None

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

ServiceController

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

Примечания

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

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

Связанные ссылки

• Get-Service
• Новая услуга
• Сервис резюме
• Set-Service
• Start-Service
• Остановить службу
• Приостановить службу
• Удалить-Службу