共用方式為

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

Description

此 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 不會傳回任何輸出。

ServiceController

當您使用 PassThru 參數時，這個 Cmdlet 會傳回代表服務的 ServiceController 物件。

備註

PowerShell 包含下列 Stop-Service別名：

  • 窗戶：
    • spsv

此 Cmdlet 僅適用於 Windows 平臺。

Stop-Service 只有在目前用戶有權執行這項操作時，才能控制服務。 如果命令無法正常運作，您可能沒有必要的許可權。

若要尋找系統上的服務名稱和顯示名稱，請輸入 Get-Service。 服務名稱會出現在 [Name] 資料行中，而顯示名稱會出現在 DisplayName 數據行中。