Stop-Service

  • 参考
模块:
Microsoft.PowerShell.Management

停止一个或多个正在运行的服务。

语法

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 平台上可用。

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 之前进行确认。

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 使用不等待选项。

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

输入

ServiceController

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

String

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

输出

None

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

ServiceController

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

备注

PowerShell 包含以下 Stop-Service 别名：

  • Windows：
    • spsv

此 cmdlet 仅在 Windows 平台上可用。

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

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