停止一或多個執行中的服務。

語法

Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Stop-Service Cmdlet 會針對各個指定的服務傳送停止訊息給 Windows 服務控制器。您可以依服務名稱或是顯示名稱指定服務,或是使用 InputObject 參數傳遞代表要停止之服務的服務物件。

參數

-DisplayName <string[]>

指定要停止之服務的顯示名稱。允許使用萬用字元。

必要?

true

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Exclude <string[]>

忽略指定的服務。此參數的值用於限定 Name 參數。輸入名稱元素或模式,例如 "s*"。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Force

允許此 Cmdlet 停止服務,即使該服務有依存服務亦然。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Include <string[]>

只停止指定的服務。此參數的值用於限定 Name 參數。輸入名稱元素或模式,例如 "s*"。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-InputObject <ServiceController[]>

指定表示要停止之服務的 ServiceController 物件。請輸入包含物件的變數,或輸入可取得物件的命令或運算式。

必要?

false

位置?

named

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Name <string[]>

指定要停止之服務的服務名稱。允許使用萬用字元。

參數名稱為選擇性。您可使用 "Name" 或其別名 "ServiceName",亦可省略參數名稱。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByValue, ByPropertyName)

接受萬用字元?

false

-PassThru

傳回代表服務的物件。根據預設,此 Cmdlet 不會產生任何輸出。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.ServiceProcess.ServiceController 或 System.String

您可以經由管道將服務物件或包含服務名稱的字串輸出至 Stop-Service。

輸出

None 或 System.ServiceProcess.ServiceController

當您使用 PassThru 參數時,Stop-Service 會產生代表此服務的 System.ServiceProcess.ServiceController 物件,否則,這個 Cmdlet 不會產生任何輸出。

附註

您也可以利用內建的別名 "spsv" 來參照 Stop-Service。如需詳細資訊,請參閱 about_Aliases。

Stop-Service 只能在目前使用者具有相關執行權限時控制該服務。如果命令無法正常運作,可能表示您不具有必要權限。

若要尋找系統上所有服務的服務名稱和顯示名稱,請輸入 "Get-Service"。此服務名稱顯示於 Name 欄,顯示名稱則顯示於 DisplayName 欄。

範例 1

C:\PS>stop-service sysmonlog

描述
-----------
這個命令會停止本機電腦上的效能記錄及警示 (SysmonLog) 服務。






範例 2

C:\PS>get-service -displayname telnet | stop-service

描述
-----------
這個命令會停止本機電腦上的 Telnet 服務。這個命令會用 Get-Service Cmdlet 取得代表 Telnet 服務的物件。管線運算子 (|) 會經由管道將此物件輸出至 Stop-Service Cmdlet,並由此 Cmdlet 停止該服務。






範例 3

C:\PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

描述
-----------
Stop-Service 命令會停止本機電腦上的 IISAdmin 服務。由於停止這項服務也會同時停止依存於 IISAdmin 服務的服務,因此最好先在 Stop-Service 命令前面加上一個命令,列出會依存於此 IISAdmin 服務的服務。

第一個命令會列出依存 IISAdmin 的服務。它會用 Get-Service Cmdlet 取得代表 IISAdmin 服務的物件。管線運算子 (|) 會將結果傳遞給 Format-List Cmdlet。這個命令會用 Format-List 的 Property 參數,僅列出服務的 Name 和 DependentServices 屬性。

第二個命令會停止 IISAdmin 服務。必須使用 Force 參數,才能停止與其他服務具有依存性的服務。這個命令會用 Confirm 參數,在停止每個服務之前向使用者要求確認。






請參閱




目錄