Resume-Service

恢复一项或多项挂起(暂停的)服务。

语法

Resume-Service
      [-InputObject] <ServiceController[]>
      [-PassThru]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Service
      [-Name] <String[]>
      [-PassThru]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Service
      [-PassThru]
      -DisplayName <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Resume-Service cmdlet 为每一个指定的服务向 Windows 服务控制器发送一条恢复消息。 如果服务暂停,则服务会恢复。 如果服务当前正在运行,则会忽略此消息。 你可以通过服务名称或显示名称来指定服务,也可以使用 InputObject 参数传递一个服务对象来代表你想要恢复的服务。

示例

示例 1:在本地计算机上恢复服务

PS C:\> Resume-Service "sens"

此命令将恢复本地计算机上的系统事件通知服务。 服务名称在命令中表示为 sens。 此命令使用 Name 参数来指定服务的服务名称,但忽略了参数名称,因为参数名称是可选的。

示例 2:恢复所有暂停的服务

PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service

此命令恢复计算机上所有暂停的服务。 Get-Service cmdlet 命令获取计算机上的所有服务。 管道运算符 (|) 将结果传递给 Where-Object cmdlet,后者选择 Status 属性为 Paused 的服务。 下一个管道运算符将结果发送给 Resume-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

-Include

指定要恢复的服务。 此参数的值会限定 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
接受通配符:False

-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 不返回任何输出。

ServiceController

使用 PassThru 参数时,此 cmdlet 返回表示已恢复服务的 ServiceController 对象。

备注

  • 已经暂停的服务的状态为 Paused。 当服务恢复后,其状态为 Running。
  • 仅在当前用户具有执行此操作的权限时,Resume-Service 才能控制服务。 如果某个命令不能正常工作,则可能你不具有所需的权限。
  • 若要查找服务名称并显示系统中的服务名称,请键入 Get-Service。 服务名称显示在 Name 列中,显示名称显示在 DisplayName 列中。