Stop-Service 帮助信息

如下说明是翻译 : help Stop-Service 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Stop-Service

 

大纲

停止一个或多个运行的服务 .

 

语法

Stop-Service [-name] <string[]> [-include <string[]>] [-exclude <string[]>] [-force] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]

 

Stop-Service -displayName <string[]> [-include <string[]>] [-exclude <string[]>] [-force] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]

 

Stop-Service [-inputObject <ServiceController[]>] [-include <string[]>] [-exclude <string[]>] [-force] [-passthru] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

Stop-Service cmdlet 向 Windows 服务控制器 (Service Controller) 为每个指定的服务发送停止消息 . 你可以通过服务名称或显示名称 (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

 

-force <SwitchParameter>

在不破坏安全前提下 , 能够避免影响命令成功执行的限制条件 . . 例如 , Force 也会停止依赖被停止服务的其他服务 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-passthru <SwitchParameter>

输出此命令创建的对象到管道中 . 默认情况下 , 此命令不会将对象输出到管道 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-displayName <string[]>

指定需要被暂停的服务名称 , 此参数接受通配符 .

 

强制参数 ?	true
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-inputObject <ServiceController[]>

挂起通过 ServiceController 对象表示的服务 . 输入一个包含对象的变量 , 或者一个能够产生对象的命令或表达式 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true (ByValue)
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

Object

 

注意

 

更多信息 , 输入 "Get-Help Stop-Service -detailed". 需要技术信息 , 输入 "Get-Help Stop-Service -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

你可以使用 Stop-Service 内建别名 "spsv". 需要更多信息 , 查看 About_Alias.

 

Stop-Service 只有在当前用户有权限时才能控制服务 . 如果命令没有正常工作 , 可能是您没有执行此操作的必要权限 .

 

要查找您系统上服务的服务名称和显示名称 , 输入命令 "get-service". 服务名称显示在列名为 "Name" 的列中 , 显示名称显示在列名为 "DisplayName" 的列中 .

 

例 1

 

C:/PS>stop-service sysmonlog

 

此命令停止本地计算机上的 Performance Logs and Alerts (SysmonLog) 服务 .

 

例 2

 

C:/PS>get-service -displayname telnet | stop-service

 

此命令停止本地计算机的 Telnet 服务 . 此命令使用 Get-Service cmdlet 取得一个表示本地的 Telnet 服务的对象 . 管道运算符将此命令结果传递给 Stop-Service cmdlet, 此命令最终将会停止该服务 .

 

例 3

 

C:/PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

 

Stop-Service 停止本地的 IISAdmin 服务 . 因为停止 IISAdmin 服务还会停止依赖它的其他服务 , 所以最好在停止命令之前 , 先查看依赖 IISAdmin 服务的的其他服务 .

 

第一条命令将会列出那些依赖 IISAdmin 的服务 . 它使用 Get-Service cmdlet 取得表示 IISAdmin 服务的对象 . 管道运算符 (|) 将结果传递给 Format-List cmdlet. 此命令通过指定 Format-List 的参数 Property, 将 IISAdmin 服务的名称 (Name) 和依赖服务 (DependentServices) 属性显示出来 .

 

第二条命令将会体制 IISAdmin 服务 . 这里需要指定参数 Force 来停止依赖此服务的其他服务 . 命令使用 参数 Confirm 在停止每个服务之前提示您进行确认 .

 

相关链接

Get-Service

Suspend-Service

Start-Service

Restart-Service

Resume-Service

Set-Service

New-Service