Start-Service
Elindít egy vagy több leállított szolgáltatást.
Syntax
InputObject (Alapértelmezett)
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
A Start-Service parancsmag indítási üzenetet küld a Windows szolgáltatásvezérlőnek az egyes megadott szolgáltatásokhoz. Ha egy szolgáltatás már fut, a rendszer hiba nélkül figyelmen kívül hagyja az üzenetet. Megadhatja a szolgáltatásokat a szolgáltatásnevek vagy megjelenítendő nevek alapján, vagy használhatja a InputObject paramétert egy olyan szolgáltatásobjektum megadásához, amely az elindítani kívánt szolgáltatásokat jelöli.
Példák
1. példa: Szolgáltatás indítása a nevével
Ez a példa elindítja az EventLog szolgáltatást a helyi számítógépen. A Name paraméter a szolgáltatásnév alapján azonosítja a szolgáltatást.
Start-Service -Name "eventlog"
2. példa: Információk megjelenítése szolgáltatás indítása nélkül
Ez a példa bemutatja, mi történne, ha elindítaná a "távoli" megjelenítési nevet tartalmazó megjelenített szolgáltatásokat.
Start-Service -DisplayName *remote* -WhatIf
A DisplayName paraméter a szolgáltatásnév helyett a megjelenített név alapján azonosítja a szolgáltatásokat. A WhatIf paraméter hatására a parancsmag megjeleníti, hogy mi történne a parancs futtatásakor, de nem végez módosításokat.
3. példa: Szolgáltatás indítása és a művelet rögzítése szövegfájlban
Ez a példa elindítja a Windows Management Instrumentation (WMI) szolgáltatást a számítógépen, és hozzáadja a művelet rekordját a services.txt fájlhoz.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
Először a Get-Service használjuk a WMI-szolgáltatást képviselő objektum lekérésére, majd a $s változóban való tárolására. Ezután elindítjuk a szolgáltatást. A PassThru paraméter nélkül Start-Service nem hoz létre kimenetet. A folyamatkezelő (|) átadja az objektum kimenetét Start-Service a Format-List parancsmagnak, hogy az objektumot a tulajdonságainak listájaként formázza. A hozzáfűző átirányítási operátor (>>) átirányítja a kimenetet a services.txt fájlba. A rendszer hozzáadja a kimenetet a meglévő fájl végéhez.
4. példa: Letiltott szolgáltatás indítása
Ez a példa bemutatja, hogyan indíthat el egy szolgáltatást, ha a szolgáltatás indítási típusa Letiltva.
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
A Telnet-szolgáltatás (tlntsvr) első indítása sikertelen. A Get-CimInstance parancs azt mutatja, hogy a Tlntsvr szolgáltatás StartMode tulajdonsága Letiltva. A Set-Service parancsmag az indítási típust Manuálistípusra módosítja. Most újra elküldhetjük a Start-Service parancsot. Ezúttal a parancs sikeres lesz. A parancs sikerességének ellenőrzéséhez futtassa a Get-Service.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DisplayName
Megadja az elindítandó szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
DisplayName
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Megadja a parancsmag által kihagyott szolgáltatásokat. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Megadja azokat a szolgáltatásokat, amelyeket ez a parancsmag elindít. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Az elindítandó szolgáltatásokat képviselő ServiceController objektumokat adja meg. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.
Paramétertulajdonságok
| Típus: | ServiceController[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InputObject
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja az elindítandó szolgáltatás szolgáltatásneveit.
A paraméter neve nem kötelező. Használhatja Név vagy annak aliasát, ServiceName, vagy kihagyhatja a paraméter nevét.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Szolgáltatás neve |
Paraméterkészletek
Default
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
A szolgáltatást jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
System.ServiceProcess.ServiceController, System.String
A parancsmag szolgáltatásneveit tartalmazó szolgáltatásokat vagy sztringeket ábrázoló objektumokat csövezhet.
Kimenetek
None, System.ServiceProcess.ServiceController
Ez a parancsmag létrehoz egy System.ServiceProcess.ServiceController objektumot, amely a szolgáltatást jelöli, ha megadja PassThru. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
- A
Start-Serviceis hivatkozhat a beépített aliasára,sasv. További információ: about_Aliases. -
Start-Servicecsak akkor tudja vezérelni a szolgáltatásokat, ha az aktuális felhasználó rendelkezik erre vonatkozó engedéllyel. Ha egy parancs nem működik megfelelően, előfordulhat, hogy nem rendelkezik a szükséges engedélyekkel. - A szolgáltatások nevének és a szolgáltatások megjelenítendő nevének megkereséséhez írja be a
Get-Service. A szolgáltatásnevek a Név oszlopban jelennek meg, a megjelenítendő nevek pedig a DisplayName oszlopban jelennek meg. - Csak azokat a szolgáltatásokat indíthatja el, amelyek indítási típusa manuális, automatikus vagy automatikus (késleltetett indítás). Nem indíthatja el azokat a szolgáltatásokat, amelyek indítási típusa le van tiltva. Ha egy
Start-Serviceparancs aCannot start service \<service-name\> on computerüzenettel meghiúsul, aGet-CimInstancesegítségével keresse meg a szolgáltatás indítási típusát, és ha kell, aSet-Serviceparancsmaggal módosítsa a szolgáltatás indítási típusát. - Egyes szolgáltatások, például a teljesítménynaplók és a riasztások (SysmonLog) automatikusan leállnak, ha nincs teendő. Amikor a PowerShell elindít egy olyan szolgáltatást, amely szinte azonnal leáll, a következő üzenet jelenik meg:
Service \<display-name\> start failed.