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 之前进行确认。

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

指定此 cmdlet 省略的服务。 此参数值使 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

指定此 cmdlet 重启的服务。 此参数值使 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

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

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

-WhatIf

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

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

输入

ServiceController

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

String

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

输出

None

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

ServiceController

使用 PassThru 参数时，此 cmdlet 返回表示重启服务的 ServiceController 对象。

备注

此 cmdlet 仅在 Windows 平台上可用。

  • 仅在当前用户具有执行此操作的权限时，Restart-Service 才能控制服务。 如果某个命令不能正常工作，则可能你不具有所需的权限。
  • 若要查找服务名称并显示系统中的服务名称，请键入 Get-Service"。 服务名称显示在 Name 列中，显示名称显示在 DisplayName 列中。