Suspend-Service

参考

模块:: Microsoft.PowerShell.Management

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

语法

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

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

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

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

参数

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

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

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	True

-Exclude

指定要从指定服务中省略的服务。此参数的值限定 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

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

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

类型:	String[]
别名:	ServiceName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

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