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

说明

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

输入

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 列中。

通过