Restart-Service
停止并接着启动一个或更多服务。
语法
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 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 |
输入
System.ServiceProcess.ServiceController, System.String
可以通过管道将服务对象或包含服务名称的字符串传递给此 cmdlet。
输出
None, System.ServiceProcess.ServiceController
如果指定 PassThru 参数,此 cmdlet 将生成一个 System.ServiceProcess.ServiceController 对象,该对象表示重启的服务。 否则,此 cmdlet 将不生成任何输出。
备注
- 仅当当前用户有权执行此操作时,Restart-Service 才能控制服务。 如果某个命令不能正常工作,则可能你不具有所需的权限。
- 若要在系统上查找服务名称和显示服务的名称,请键入 Get-Service”。 服务名称显示在 “名称” 列中,显示名称显示在 “DisplayName” 列中。