Start-Service
啟動一或多個已停止的服務。
Syntax
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet 會 Start-Service
針對每個指定的服務,將啟動訊息傳送至 Windows 服務控制器。 如果服務正在執行,系統會忽略該訊息,且沒有錯誤。 您可以依服務的服務名稱或顯示名稱來指定服務,或是使用 InputObject 參數來提供代表您要啟動之服務的服務物件。
範例
範例 1︰使用名稱啟動服務
此範例會在本機計算機上啟動 EventLog 服務。 Name 參數會依服務名稱來識別服務。
Start-Service -Name "eventlog"
範例 2︰顯示資訊,但不啟動服務
此範例顯示如果您啟動的服務具有包含 「remote」 的顯示名稱,會發生什麼情況。
Start-Service -DisplayName *remote* -WhatIf
DisplayName 參數會依其顯示名稱而非服務名稱來識別服務。 WhatIf 參數會導致 Cmdlet 顯示當您執行命令但不會進行變更時會發生什麼情況。
範例 3︰啟動服務,並在文字檔中記錄動作
本範例會啟動電腦上的 Windows Management Instrumentation (WMI) 服務,並將動作的記錄新增至 services.txt 檔案。
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
首先,我們使用 Get-Service
來取得代表 WMI 服務的物件,並將它儲存在變數中 $s
。 接下來,我們會啟動服務。 如果沒有 PassThru 參數, Start-Service
就不會建立任何輸出。 管線運算子 (|) 將 對象輸出 Start-Service
傳遞至 Format-List
Cmdlet,以將物件格式化為其屬性的清單。 附加重新導向運算子 (>>) 會將輸出重新導向至 services.txt 檔案。 輸出會新增至現有檔案的結尾。
範例 4︰啟動停用的服務
此範例示範如何在服務的啟動類型為 Disabled 時啟動服務。
PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service <<<< tlntsvr
PS> Get-CimInstance win32_service | Where-Object Name -eq "tlntsvr"
ExitCode : 0
Name : TlntSvr
ProcessId : 0
StartMode : Disabled
State : Stopped
Status : OK
PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr
第一次嘗試啟動 Telnet 服務 (tlntsvr) 失敗。 Get-CimInstance
此命令顯示 Tlntsvr 服務的 StartMode 屬性為 Disabled。 Cmdlet 會將 Set-Service
開始類型變更為 [手動]。 現在,我們可以重新提交 Start-Service
命令。 這次命令會執行成功。 若要確認指令成功,請執行 Get-Service
。
參數
-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 |
-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
指定要啟動之服務的服務名稱。
參數名稱為選擇性。 您可以使用 Name 或其別名、 ServiceName,或省略參數名稱。
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
輸入
System.ServiceProcess.ServiceController, System.String
您可以使用管線將代表服務的物件,或是包含服務名稱的字串傳送至此 Cmdlet。
輸出
None, System.ServiceProcess.ServiceController
如果您指定 PassThru,此 Cmdlet 會產生代表該服務的 System.ServiceProcess.ServiceController 物件。 否則,此 Cmdlet 不會產生任何輸出。
備註
此 Cmdlet 僅適用於 Windows 平臺。
- 您也可以
Start-Service
參考其內建別名 。sasv
如需詳細資訊,請參閱 about_Aliases。 Start-Service
只有在目前用戶有權執行這項操作時,才能控制服務。 若命令無法正確運作,您可能沒有必要的權限。- 若要尋找系統上服務的服務名稱和顯示名稱,請輸入
Get-Service
。 服務名稱會出現在 [ 名稱 ] 資料行中,而顯示名稱會出現在 DisplayName 數據行中。 - 您只能啟動啟動類型為 Manual、Automatic 或 Automatic (Delayed Start) 的服務。 您無法啟動啟動類型是 Disabled 的服務。
Start-Service
如果命令失敗並出現訊息Cannot start service \<service-name\> on computer
,請使用Get-CimInstance
來尋找服務的啟動類型,而且您必須使用Set-Service
Cmdlet 來變更服務的啟動類型。 - 某些服務,例如效能記錄及警示 (SysmonLog),在沒有執行任何工作時會自動停止。 當 PowerShell 啟動幾乎立即停止本身的服務時,它會顯示下列訊息:
Service \<display-name\> start failed.