Suspend-Service
暫停（暫停）一或多個執行中的服務。
語法
InputObject (預設值)
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Suspend-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Suspend-Service Cmdlet 會針對每個指定的服務，將暫止訊息傳送至 Windows 服務控制器。 暫停時，服務仍在執行中，但其動作會停止，直到繼續為止，例如使用 Resume-Service Cmdlet。 您可以依服務名稱或顯示名稱來指定服務，也可以使用 InputObject 參數來傳遞服務物件，此物件代表您想要暫停的服務。
範例
範例 1：暫停服務
PS C:\> Suspend-Service -DisplayName "Telnet"
此命令會暫停本機電腦上的 Telnet 服務 （Tlntsvr） 服務。
範例 2：顯示暫停服務時會發生什麼事
PS C:\> Suspend-Service -Name lanman* -WhatIf
此命令會指出如果您暫停的服務名稱開頭為 lanman 的服務，會發生什麼情況。 若要暫停服務，請重新執行命令，而不需 WhatIf 參數。
範例 3：取得和暫停服務
PS C:\> Get-Service schedule | Suspend-Service
此命令會使用 Get-Service Cmdlet 來取得物件，代表計算機上的工作排程器 （Schedule） 服務。
管線運算子 （|） 會將結果傳遞至暫停服務的 suspend-Service
範例 4：暫停所有可暫停的服務
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm
此命令會暫停電腦上所有可以暫停的服務。
它會使用 Get-Service 來取得代表電腦上服務的物件。
管線運算符會將結果傳遞至 Where-Object Cmdlet，它只會選取 CanPauseAndContinue 屬性值為 $True 的服務。
另一個管線運算符會將結果傳遞至 suspend-Service
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayName
指定要暫停之服務的顯示名稱。 允許使用通配符字元。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
DisplayName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Exclude
指定要從指定服務省略的服務。 此參數的值用來說明 Name 參數。 輸入名稱專案或模式，例如 「s*」。 允許使用通配符字元。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Include
指定要暫停的服務。 此參數的值用來說明 Name 參數。 輸入名稱專案或模式，例如 「s*」。 允許使用通配符字元。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定要暫停的服務 ServiceController 物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。
參數屬性
| 類型: | ServiceController[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
InputObject
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定要暫停的服務服務名稱。 允許使用通配符字元。
參數名稱是選擇性的。 您可以使用 Name 或其別名、ServiceName，或省略參數名稱。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
| 別名: | 服務名稱 |
參數集
Default
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PassThru
返回一個物件，代表您正在處理的項目。 根據預設，此 Cmdlet 不會產生任何輸出。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
System.ServiceProcess.ServiceController, System.String
您可以使用管線將服務物件或包含服務名稱的字串傳送至此 Cmdlet。
輸出
None, System.ServiceProcess.ServiceController
如果您 指定 passThru 參數，此 Cmdlet 會產生代表服務的 System.ServiceProcess.ServiceController 物件。 否則，此 Cmdlet 不會產生任何輸出。
備註
- Suspend-Service 只有在目前使用者有權執行這項操作時，才能控制服務。 如果命令無法正常運作，您可能沒有必要的許可權。
-
Suspend-Service 只能暫停支持暫停和繼續的服務。 若要判斷是否可以暫停特定服務，請使用 Get-Service Cmdlet 搭配 CanPauseAndContinue 屬性。 例如：
Get-Service wmi | Format-List Name, CanPauseAndContinue。 若要在可以暫停的電腦上尋找所有服務，請輸入Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}。 - 若要尋找系統上的服務名稱和顯示名稱，請輸入 Get-Service。 服務名稱會出現在 [Name] 資料行中，而顯示名稱會出現在 DisplayName 數據行中。