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

类型:	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 不返回任何输出。