Restart-Service

語法

Restart-Service
       [-Force]
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restart-Service
       [-Force]
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restart-Service
       [-Force]
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Cmdlet 會 Restart-Service 傳送停止訊息，然後將啟動訊息傳送至指定服務的 Windows 服務控制器。 如果服務已停止，則會啟動，而不會通知您錯誤。 您可以依服務名稱或顯示名稱來指定服務，也可以使用 InputObject 參數來傳遞物件，代表您想要重新啟動的每個服務。

範例

範例 1：重新啟動本機電腦上的服務

PS C:\> Restart-Service -Name winmgmt

此命令會重新啟動本機電腦上的 Windows Management Instrumentation 服務 （WinMgmt）。

範例 2：排除服務

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

此命令會重新啟動顯示名稱開頭為 Net 的服務，但 Net Logon 服務除外。

範例 3：啟動所有已停止的網路服務

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

此命令會啟動電腦上所有已停止的網路服務。

此命令會 Get-Service 使用 Cmdlet 來取得物件，這些物件表示服務名稱開頭為 net 的服務。 管線運算符 （|） 會將 services 物件傳送至 Where-Object Cmdlet，該 Cmdlet 只會選取狀態為已停止的服務。 另一個管線運算子會將選取的服務傳送至 Restart-Service。

在實務上 ，您會使用 WhatIf 參數來判斷命令的效果，再執行命令。

參數

-Confirm

-DisplayName

-Exclude

-Force

-Include

-InputObject

-Name

-PassThru

-WhatIf

輸入

ServiceController

您可以使用管線將服務物件傳送至此 Cmdlet。

String

您可以使用管線將包含服務名稱的字串傳送至此 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

ServiceController

當您使用 PassThru 參數時，此 Cmdlet 會 傳回代表重新啟動服務的 ServiceController 物件。

備註

• Restart-Service 只有在目前使用者具有執行這項操作的許可權時，才能控制服務。 如果命令無法正常運作，您可能沒有必要的許可權。
• 若要在您的系統上尋找服務名稱和顯示服務名稱，請輸入 Get-Service” 服務名稱會出現在 [名稱] 資料行中，而顯示名稱會出現在 DisplayName 數據行中。

相關連結

• Get-Service
• New-Service
• Resume-Service
• Set-Service
• Start-Service
• Stop-Service
• Suspend-Service