通过

Suspend-Service

模块:
Microsoft.PowerShell.Management Module

暂停（暂停）一个或多个正在运行的服务。

语法

InputObject （默认值） 

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

Default 

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

DisplayName 

Suspend-Service
    -DisplayName <String[]>
    [-PassThru]
    [-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 获取一个对象，该对象表示计算机上的任务计划程序（计划）服务。 管道运算符（|）将结果传递给 Suspend-Service，这会挂起服务。

示例 4：挂起可挂起的所有服务

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

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

参数

-Confirm

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

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DisplayName

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

DisplayName
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Exclude

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Include

指定要挂起的服务。 此参数的值用于限定 Name 参数。 输入名称元素或模式，例如“s*”。 允许使用通配符。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InputObject

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

参数属性

类型:

ServiceController[]

默认值:None
支持通配符:False
不显示:False

参数集

InputObject
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

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

参数名称是可选的。 可以使用 名称 或其别名、ServiceName，也可以省略参数名称。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False
别名:服务名称

参数集

Default
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-PassThru

返回一个对象，该对象表示你正在处理的项目。 默认情况下，此 cmdlet 不生成任何输出。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

System.ServiceProcess.ServiceController, System.String

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

输出

None, System.ServiceProcess.ServiceController

如果指定 PassThru 参数，此 cmdlet 将生成表示服务的 System.ServiceProcess.ServiceController 对象。 否则，此 cmdlet 不会生成任何输出。

备注

此 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。 服务名称显示在 名称 列中，显示名称显示在 DisplayName 列中。