Stop-Service
停止一个或多个正在运行的服务。
语法
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
此 cmdlet 仅在 Windows 平台上可用。
cmdlet 为每个 Stop-Service 指定的服务向 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。 命令使用 的 Property 参数 Format-List 仅列出服务的 Name 和 DependentServices 属性。
第二个命令停止 IISAdmin 服务。 需要 Force 参数来停止具有依赖服务的服务。 命令使用 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
指定此 cmdlet 省略的服务。 此参数值使 Name 参数有效。 输入名称元素或模式，例如 s*。 允许使用通配符。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
强制 cmdlet 停止服务，即使该服务具有依赖服务。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
指定此 cmdlet 停止的服务。 此参数值使 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
指定要停止的服务的服务名称。 允许使用通配符。
| Type: | String[] |
| Aliases: | ServiceName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-NoWait
指示此 cmdlet 使用 no wait 选项。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 平台上可用。
还可以通过其内置别名 spsv 引用Stop-Service。 有关详细信息，请参阅 about_Aliases。
Stop-Service 仅当当前用户有权执行此操作时，才能控制服务。 如果某个命令不能正常工作，则可能你不具有所需的权限。
若要查找服务名称并显示系统中的服务名称，请键入 Get-Service。 服务名称显示在 “名称” 列中，显示名称显示在 “DisplayName” 列中。