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

说明

此 cmdlet 仅在 Windows 平台上可用。

Restart-Service cmdlet 向指定服务的 Windows 服务控制器发送停止消息，然后发送启动消息。如果服务已停止，则会启动该服务，而不会通知你出现错误。可以按服务名称或显示名称指定服务，也可以使用 InputObject 参数传递表示要重启的每个服务的对象。

示例

示例 1：在本地计算机上重启服务

PS C:\> Restart-Service -Name winmgmt

此命令在本地计算机上重启 Windows Management Instrumentation 服务（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 cmdlet 获取表示服务名称以 net 开头的服务的对象。管道运算符（|）将服务对象发送到 Where-Object cmdlet，该 cmdlet 仅选择状态为“已停止”的服务。另一个管道运算符将所选服务发送到 Restart-Service。

在实践中，你将使用 WhatIf 参数来确定命令的效果，然后再运行它。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

指定要重启的服务的显示名称。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	True

-Exclude

指定此 cmdlet 省略的服务。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Force

强制命令运行而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Include

指定此 cmdlet 重新启动的服务。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-InputObject

指定 ServiceController 表示要重启的服务的对象。输入包含对象的变量，或键入获取对象的命令或表达式。

类型:	ServiceController[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要重启的服务的服务名称。

类型:	String[]
别名:	ServiceName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-PassThru

返回一个表示服务的对象。默认情况下，此 cmdlet 不生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

ServiceController

可以通过管道将服务对象传递给此 cmdlet。

String

可以通过管道将包含服务名称的字符串传递给此 cmdlet。

输出

None

默认情况下，此 cmdlet 不返回任何输出。