Stop-Service
停止一个或多个正在运行的服务。
语法
InputObject （默认值）
Stop-Service
[-InputObject] <ServiceController[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Stop-Service
[-Name] <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Stop-Service
-DisplayName <String[]>
[-Force]
[-NoWait]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
此 cmdlet 仅在 Windows 平台上可用。
Stop-Service cmdlet 向每个指定服务的 Windows 服务控制器发送停止消息。 可以按服务名称或显示名称指定服务，也可以使用 InputObject 参数传递表示要停止的服务的服务对象。
示例
示例 1：停止本地计算机上的服务
PS C:\> Stop-Service -Name "sysmonlog"
此命令在本地计算机上停止性能日志和警报（SysmonLog）服务。
示例 2：使用显示名称停止服务
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
此命令在本地计算机上停止 Telnet 服务。 该命令使用 Get-Service 获取表示 Telnet 服务的对象。 管道运算符（|）通过管道将对象传递给 Stop-Service，这会停止服务。
示例 3：停止具有依赖服务的服务
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
此示例在本地计算机上停止 IISAdmin 服务。 由于停止此服务也会停止依赖于 IISAdmin 服务的服务，因此最好在 Stop-Service 之前使用列出依赖于 IISAdmin 服务的服务的命令。
第一个命令列出依赖于 IISAdmin 的服务。 它使用 Get-Service 获取表示 IISAdmin 服务的对象。 管道运算符（|）将结果传递给 Format-List cmdlet。 该命令使用 的 Format-List 参数仅列出服务的 Name 和 DependentServices 属性。
第二个命令停止 IISAdmin 服务。 Force 参数是停止具有依赖服务的服务所必需的。 该命令使用 Confirm 参数在停止每个服务之前请求用户确认。
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayName
指定要停止的服务的显示名称。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
DisplayName
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Exclude
指定此 cmdlet 省略的服务。 此参数的值用于限定 Name 参数。 输入名称元素或模式，例如 s*。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
强制 cmdlet 停止服务，即使该服务具有依赖服务。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Include
指定此 cmdlet 停止的服务。 此参数的值用于限定 Name 参数。 输入名称元素或模式，例如 s*。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
指定 ServiceController 表示要停止的服务的对象。 输入包含对象的变量，或键入获取对象的命令或表达式。
参数属性
| 类型: | |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InputObject
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定要停止的服务的服务名称。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
| 别名: | 服务名称 |
参数集
Default
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-NoWait
指示此 cmdlet 不使用等待选项。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
返回一个表示服务的对象。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
ServiceController
可以通过管道将服务对象传递给此 cmdlet。
String
可以通过管道将包含服务名称的字符串传递给此 cmdlet。
输出
None
默认情况下，此 cmdlet 不返回任何输出。
ServiceController
使用 PassThru 参数时，此 cmdlet 将返回表示服务的 ServiceController 对象。
备注
PowerShell 包含以下与 Stop-Service相关的别名：
- 窗户：
spsv
此 cmdlet 仅在 Windows 平台上可用。
仅当当前用户有权执行此作时，Stop-Service 才能控制服务。 如果命令无法正常工作，则可能没有所需的权限。
若要查找系统上的服务名称和显示名称，请键入 Get-Service。 服务名称显示在 名称 列中，显示名称显示在 DisplayName 列中。
