如下说明是翻译: help Suspend-Service 产生的帮助信息.
译者: Edengundam(马涛)
Suspend-Service
大纲
挂起 (暂停) 一个或多个运行的服务.
语法
Suspend-Service [-name] <string[]> [-passthru] [-include <string[]>] [-exclude <string[]>] [-whatIf] [-confirm] [<CommonParameters>]
Suspend-Service -displayName <string[]> [-passthru] [-include <string[]>] [-exclude <string[]>] [-whatIf] [-confirm] [<CommonParameters>]
Suspend-Service [-passthru] [-inputObject <ServiceController[]>] [-include <string[]>] [-exclude <string[]>] [-whatIf] [-confirm] [<CommonParameters>]
详细描述
Suspend-Service cmdlet向Windows服务控制器(Service Controller)为每个指定的服务发送挂起消息. 当服务处于挂起状态, 该服务依然运行但是该服务被暂停, 通过Resume-Service可以继续执行该服务. 你可以通过服务名称或显示名称(display name)来指定需要挂起的服务. 你还可以使用参数InputObject传递你需要挂起的服务对象(译者注: 例如使用Get-Service返回的对象或对象列表).
参数
-name <string[]>
指定需要被暂停的服务名称, 此参数接受通配符.
此参数可以在命令行忽略. 你既可以使用"-Name", 也可以使用其别名"-ServiceName", 甚至忽略此参数名.
强制参数?
|
true
|
参数位置?
|
1
|
默认值
|
|
允许从管道绑定输入?
|
true (根据值, 根据属性名)
|
允许通配符扩展?
|
true
|
-include <string[]>
只将指定的服务挂起. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"s*"(此参数允许通配符).
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
true
|
-exclude <string[]>
忽略指定的服务. 此参数值用于限定Path参数.输入一个路径元素或模式, 例如"s*"(此参数允许通配符).
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
true
|
-displayName <string[]>
指定需要被暂停的服务名称, 此参数接受通配符.
强制参数?
|
true
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
true
|
-passthru <SwitchParameter>
输出此命令创建的对象到管道中. 默认情况下, 此命令不会将对象输出到管道.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
False
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
-inputObject <ServiceController[]>
挂起通过ServiceController对象表示的服务. 输入一个包含对象的变量, 或者一个能够产生对象的命令或表达式.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
true (根据值)
|
允许通配符扩展?
|
false
|
-whatIf
描述执行此命令将会发生的现象, 不会真正执行此命令.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
-confirm
执行命令前提示你进行确认.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
<公共参数>
此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".
输入类型
对象
注意
更多信息, 输入"Get-Help Suspend-Service -detailed".需要技术信息, 输入"Get-Help Suspend-Service -full".
如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".
Suspend-Service只有在当前用户有权限时才能控制服务. 如果命令没有正常工作, 可能是您没有执行此操作的必要权限.
Suspend-Service只能挂起那些支持挂起和继续操作的服务. 使用Get-Service cmdlet和"CanPauseAndContinue"属性, 可以确定一个特定服务是否能够被挂起. 例如, "get-service wmi | format-list name, canpauseandcontinue". 要查看计算机上所有支持挂起操作的服务, 可以输入命令: "get-service | where {$_.canpauseandcontinue -eq "True"}".
要查找您系统上服务的服务名称和显示名称, 输入命令"get-service". 服务名称显示在列名为"Name"的列中, 显示名称显示在列名为"DisplayName"的列中.
例1
C:/PS>suspend-service -displayname "Telnet"
此命令挂起本地的Telnet service (Tlntsvr)服务.
例2
C:/PS>suspend-service -name lanman* -whatif
此命令将告诉您如果您挂起以”lanman”开头的所有服务将会发生的现象. 要挂起这些服务, 重新运行并去掉参数Whatif.
例3
C:/PS>get-service schedule | suspend-service
此命令使用Get-Service cmdlet取得一个表示本地的Task Scheduler (Schedule)服务的对象. 管道运算符将此命令结果传递给Suspend-Service cmdlet, 此命令最终将会暂停该服务.
例4
C:/PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm
此命令将会挂起计算机上所有允许挂起操作的服务. 它使用Get-Service cmdlet取得计算机上的服务对象. 管道运算符(|)将结果发送给Where-Object cmdlet, Where-Object将会只选取那些CanPauseAndContinue属性值为真的服务. 另一个管道运算符将结果发送给Suspend-Service cmdlet. 参数Confirm在挂起每个进程之前提示您进行确认.
相关链接
Get-Service
Start-Service
Stop-Service
Restart-Service
Resume-Service
Set-Service
New-Service