Start-Service
Spustí jednu nebo více zastavených služeb.
Syntax
InputObject (Výchozí)
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Start-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Tato rutina je dostupná jenom na platformě Windows.
Rutina Start-Service odešle úvodní zprávu kontroleru služeb systému Windows pro každou ze zadaných služeb. Pokud už je služba spuštěná, zpráva se ignoruje bez chyby. Služby můžete zadat podle jejich názvů služeb nebo zobrazovaného názvu, nebo můžete použít parametr InputObject k poskytnutí objektu služby, který představuje služby, které chcete spustit.
Příklady
Příklad 1: Spuštění služby pomocí jejího názvu
Tento příklad spustí službu EventLog na místním počítači. Parametr Name identifikuje službu podle názvu služby.
Start-Service -Name "eventlog"
Příklad 2: Zobrazení informací bez spuštění služby
Tento příklad ukazuje, co by se stalo, když jste spustili služby, které mají zobrazovaný název, který obsahuje "remote".
Start-Service -DisplayName *remote* -WhatIf
Parametr DisplayName identifikuje služby podle jejich zobrazovaného názvu místo názvu služby. Parametr WhatIf způsobí, že rutina zobrazí, co by se stalo při spuštění příkazu, ale neprovádí změny.
Příklad 3: Spuštění služby a zaznamenání akce v textovém souboru
Tento příklad spustí službu WMI (Windows Management Instrumentation) v počítači a přidá záznam akce do services.txt souboru.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
Nejprve použijeme Get-Service k získání objektu, který představuje službu WMI, a uložíme ho do proměnné $s. Dále spustíme službu. Bez parametru PassThruStart-Service nevytváří žádný výstup. Operátor kanálu (|) předá výstup objektu Start-Service rutině Format-List, aby objekt naformátovala jako seznam jeho vlastností. Operátor přesměrování připojení (>>) přesměruje výstup do souboru services.txt. Výstup se přidá na konec existujícího souboru.
Příklad 4: Spuštění zakázané služby
Tento příklad ukazuje, jak spustit službu, když je typ spuštění služby Zakázáno.
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
První pokus o spuštění služby Telnet (tlntsvr) selže. Příkaz Get-CimInstance ukazuje, že vlastnost StartMode služby Tlntsvr je Disabled. Rutina Set-Service změní typ spuštění na Ruční. Teď můžeme příkaz Start-Service znovu odeslat. Tentokrát příkaz proběhne úspěšně. Pokud chcete ověřit, že příkaz proběhl úspěšně, spusťte Get-Service.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DisplayName
Určuje zobrazované názvy služeb, které se mají spustit. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
DisplayName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Exclude
Určuje služby, které tato rutina vynechá. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Určuje služby, které tato rutina spustí. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje ServiceController objekty představující služby, které se mají spustit. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje názvy služeb, které se mají spustit.
Název parametru je volitelný. Můžete použít Název nebo jeho alias, ServiceNamenebo můžete vynechat název parametru.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Název služby |
Sady parametrů
Default
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt, který představuje službu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.ServiceProcess.ServiceController, System.String
Objekty, které představují služby nebo řetězce, které obsahují názvy služeb pro tuto rutinu, můžete pipetovat.
Výstupy
None, System.ServiceProcess.ServiceController
Tato rutina vygeneruje System.ServiceProcess.ServiceController objekt, který představuje službu, pokud zadáte PassThru. Jinak tento příkaz negeneruje žádný výstup.
Poznámky
Tento cmdlet je dostupný pouze na platformách Windows.
- Můžete také odkazovat na
Start-Servicejeho předdefinovaný aliassasv. Další informace viz about_Aliases. -
Start-Servicemůže řídit služby pouze v případě, že má aktuální uživatel oprávnění k tomu. Pokud příkaz nefunguje správně, možná nemáte požadovaná oprávnění. - Chcete-li najít názvy služeb a zobrazované názvy služeb v systému, zadejte
Get-Service. Názvy služeb se zobrazí ve sloupci Název a zobrazované názvy se zobrazí ve sloupci DisplayName. - Můžete spustit pouze služby, které mají typ spuštění Ruční, Automatické nebo Automatické (Zpožděné spuštění). Služby, které mají typ Spuštění zakázáno, nelze spustit. Pokud příkaz
Start-Serviceselže se zprávouCannot start service \<service-name\> on computer, pomocíGet-CimInstancevyhledejte typ spuštění služby a v případě potřeby změňte typ spuštění služby pomocí rutinySet-Service. - Některé služby, jako jsou protokoly výkonu a výstrahy (SysmonLog), se automaticky zastaví, pokud nemají žádnou práci. Když PowerShell spustí službu, která se téměř okamžitě zastaví, zobrazí následující zprávu:
Service \<display-name\> start failed.