Stop-Service
停止一或多個執行中的服務。
Syntax
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>]
Description
此 Cmdlet 僅適用於 Windows 平臺。
Cmdlet Stop-Service
會針對每個指定的服務,將停止訊息傳送至 Windows 服務控制器。 您可以依服務名稱或顯示名稱來指定服務,也可以使用 InputObject 參數來傳遞服務物件,代表您想要停止的服務。
範例
範例 1:停止本機計算機上的服務
PS C:\> Stop-Service -Name "sysmonlog"
此命令會停止本機電腦上的 Performance Logs and Alerts (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 |
輸入
您可以使用管線將服務物件傳送至此 Cmdlet。
您可以使用管線將包含服務名稱的字串傳送至此 Cmdlet。
輸出
None
根據預設,此 Cmdlet 不會傳回任何輸出。
當您使用 PassThru 參數時,此 Cmdlet 會傳回代表服務的 ServiceController 物件。
備註
PowerShell 包含的下列別名 Stop-Service
:
- Windows:
spsv
此 Cmdlet 僅適用於 Windows 平臺。
Stop-Service
只有在目前用戶有權執行這項操作時,才能控制服務。 若命令無法正確運作,您可能沒有必要的權限。
若要尋找系統上服務的服務名稱和顯示名稱,請輸入 Get-Service
。 服務名稱會出現在 [ 名稱] 資料行中,而顯示名稱會出現在 DisplayName 數據行中。