如下说明是翻译
: help Restart-Service
产生的帮助信息
.
译者
: Edengundam(
马涛
)
Restart-Service
大纲
停止再重新启动服务
.
语法
Restart-Service [-name] <string[]> [-force] [-include <string[]>] [-exclude <string[]>] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]
Restart-Service -displayName <string[]> [-force] [-include <string[]>] [-exclude <string[]>] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]
Restart-Service [-inputObject <ServiceController[]>] [-force] [-include <string[]>] [-exclude <string[]>] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]
详细描述
对于每一个你重启的服务
, Restart-Service cmdlet
向
Windows
服务控制器
(Service Controller)
为每个指定的服务发送一个停止消息
,
再接着发送一个启动消息
.
如果服务已经听
,
那么将会被直接启动
,
你不会收到任何错误信息
.
你可以通过服务名称或显示名称
(display name)
来指定需要重新启动的服务
.
你还可以使用参数
InputObject
传递你需要重新启动的服务对象
(
译者注
:
例如使用
Get-Service
返回的对象或对象列表
).
参数
-name <string[]>
指定需要被重新启动的服务名称
,
此参数接受通配符
.
强制参数
?
|
true
|
参数位置
?
|
1
|
默认值
|
|
允许从管道绑定输入
?
|
true (
根据值
,
根据属性名
)
|
允许通配符扩展
?
|
true
|
-include <string[]>
只将指定的服务重新启动
.
此参数值用于限定
Name
参数
.
输入一个路径元素或模式
,
例如
"s*"(
此参数允许通配符
)
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
true
|
-exclude <string[]>
忽略指定的服务
.
此参数值用于限定
Name
参数
.
输入一个路径元素或模式
,
例如
"s*"(
此参数允许通配符
)
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
true
|
-passthru <SwitchParameter>
输出此命令创建的对象到管道中
.
默认情况下
,
此命令不会将对象输出到管道
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
False
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
-displayName <string[]>
指定需要被重新启动的服务名称
,
此参数接受通配符
..
强制参数
?
|
true
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
true
|
-inputObject <ServiceController[]>
重新启动通过
ServiceController
对象表示的服务
.
输入一个包含对象的变量
,
或者一个能够产生对象的命令或表达式
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
true (
根据值
)
|
允许通配符扩展
?
|
false
|
-force <SwitchParameter>
Overrides restrictions that prevent the command from succeeding, just so the changes do not compromise security. For example, Force will stop and restart a service that has dependent services.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
False
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
-whatIf
描述执行此命令将会发生的现象
,
不会真正执行此命令
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
-confirm
执行命令前提示你进行确认
.
强制参数
?
|
false
|
参数位置
?
|
named
|
默认值
|
|
允许从管道绑定输入
?
|
false
|
允许通配符扩展
?
|
false
|
<
公共参数
>
此命令支持公共参数
: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable.
更多信息
,
输入
, "get-help about_commonparameters".
输入类型
Object
注意
更多信息
,
输入
"Get-Help Restart-Service -detailed".
需要技术信息
,
输入
"Get-Help Restart-Service -full".
Restart-Service
只有在当前用户有权限时才能控制服务
.
如果命令没有正常工作
,
可能是您没有执行此操作的必要权限
要查找您系统上服务的服务名称和显示名称
,
输入命令
"get-service".
服务名称显示在列名为
"Name"
的列中
,
显示名称显示在列名为
"DisplayName"
的列中
.
如果需要为该命令提供多个参数
,
请使用逗号进行分隔
.
例如
, "<parameter-name> <value1>, <value2>".
例
1
C:/PS>restart-service wmi
此命令重新启动本地计算机上的
Windows Management Instrumentation (WMI)
服务
.
例
2
C:/PS>restart-service -displayname net* -exclude "net logon"
此命令重新启动除了叫
"Net Logon"
的服务外
,
显示名称以
"Net"
开头的服务
.
例
3
C:/PS>get-service net* | where {$_.Status -eq "Stopped"} | restart-service
此命令启动计算机上所有停止的网络服务
.
它首先使用
Get-Service
cmdlet
获得那些以
"net"
开头的服务表示的对象
. (
这里省略了可选参数
Name.)
管道运算符
(|)
将服务对象发送给
Where-Object
cmdlet,
此命令将筛选那些状态为
"stopped"
的服务
.
第二个管道运算符将选择的结果发送给
Restart-Service.
实际应用中
,
你应该在真正执行这个命令之前
,
首先使用参数
Whatif
来确定此命令的影响
.
相关链接
Start-Service
Stop-Service
Suspend-Service
Resume-Service
New-Service
Get-Service
Set-Service