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>]
说明
该 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-Service
。 在暂停每个服务之前, Confirm 参数会提示你进行确认。
参数
-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 |
输入
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 列中。