Suspend-Service

挂起(暂停)一个或多个正在运行的服务。

语法

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

说明

此 cmdlet 仅在 Windows 平台上可用。

Suspend-Service cmdlet 为每一个指定的服务向 Windows 服务控制器发送一条暂停消息。 挂起时,服务仍在运行,但其操作将停止,直到使用 Resume-Service cmdlet 等方法恢复该服务。 你可以通过服务名称或显示名称来指定服务,也可以使用 InputObject 参数传递一个服务对象来代表你想要暂停的服务。

示例

示例 1:暂停服务

PS C:\> Suspend-Service -DisplayName "Telnet"

此命令挂起本地计算机上的 Telnet 服务 (Tlntsvr)。

示例 2:显示暂停服务时会发生什么情况

PS C:\> Suspend-Service -Name lanman* -WhatIf

此命令显示在挂起服务名称以 lanman 开头的服务后会发生的情况。 若要挂起服务,请在不带 WhatIf 参数的情况下重新运行该命令。

示例 3:获取和暂停服务

PS C:\> Get-Service schedule | Suspend-Service

此命令使用 Get-Service cmdlet 来获取计算机上表示任务计划程序 (Schedule) 服务的对象。 管道运算符 (|) 将结果传递给 Suspend-Service,这将暂停服务。

示例 4:暂停可暂停的所有服务

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

此命令挂起计算机上所有可挂起的服务。 它使用 Get-Service 来获取表示计算机上的服务的对象。 管道运算符将结果传递给 Where-Object cmdlet,该 cmdlet 仅为 CanPauseAndContinue 属性选择值为 $True 的服务。 另一个管道运算符将结果传递给 Suspend-ServiceConfirm 参数用于在挂起每个服务前提示你进行确认。

参数

-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

指定要从指定服务中省略的服务。 此参数值使 Name 参数有效。 请输入名称元素或模式,例如“s*”。 允许使用通配符。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

指定要暂停的服务。 此参数值使 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

指定要暂停的服务的服务名称。 允许使用通配符。

参数名为可选项。 可以使用 Name 或其别名 ServiceName,也可忽略该参数名。

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 平台上可用。

  • 仅在当前用户具有执行此操作的权限时,Suspend-Service 才能控制服务。 如果某个命令不能正常工作,则可能你不具有所需的权限。
  • Suspend-Service 只能暂停支持暂停并恢复的服务。 若要确定特定服务是否可以暂停,请使用 Get-Service cmdlet 和 CanPauseAndContinue 属性。 例如 Get-Service wmi | Format-List Name, CanPauseAndContinue。 若要查找计算机上可暂停的所有服务,请键入 Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
  • 若要查找服务名称并显示系统中的服务名称,请键入 Get-Service。 服务名称显示在 Name 列中,显示名称显示在 DisplayName 列中。