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>]

说明

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 的 Property 参数,只列出服务的 Name 和 DependentServices 属性。

第二个命令停止 IISAdmin 服务。 需要使用 Force 参数来停止具有相关服务的服务。 该命令使用 Confirm 参数在停止每个服务之前请求用户进行确认。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DisplayName

指定要停止的服务的显示名称。 允许使用通配符。

类型:String[]
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:True

-Exclude

指定此 cmdlet 省略的服务。 此参数值使 Name 参数有效。 输入名称元素或模式,例如 s*。 允许使用通配符。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-Force

强制 cmdlet 停止服务(即使该服务有相关服务)。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Include

指定此 cmdlet 停止的服务。 此参数值使 Name 参数有效。 输入名称元素或模式,例如 s*。 允许使用通配符。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-InputObject

指定 ServiceController 对象来表示要停止的服务。 输入一个包含对象的变量,或键入可获取对象的命令或表达式。

类型:ServiceController[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定要停止的服务的服务名称。 允许使用通配符。

类型:String[]
别名:ServiceName
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:True

-NoWait

指示此 cmdlet 使用不等待选项。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PassThru

返回一个表示服务的对象。 默认情况下,此 cmdlet 将不产生任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

ServiceController

可以通过管道将服务对象传递给此 cmdlet。

String

可以将包含服务名称的字符串通过管道传递给此 cmdlet。

输出

None

默认情况下,此 cmdlet 不返回任何输出。

ServiceController

使用 PassThru 参数时,此 cmdlet 返回表示该服务的 ServiceController 对象。

备注

Windows PowerShell 包含以下 Stop-Service 别名:

  • spsv

仅在当前用户具有执行此操作的权限时,Stop-Service 才能控制服务。 如果某个命令不能正常工作,则可能你不具有所需的权限。

若要查找服务名称并显示系统中的服务名称,请键入 Get-Service。 服务名称显示在 Name 列中,显示名称显示在 DisplayName 列中。