Start-Service

  • Referencia
Modul:
Microsoft.PowerShell.Management

Elindít egy vagy több leállított szolgáltatást.

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

Ez a parancsmag csak a Windows platformon érhető el.

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 az InputObject paraméterrel megadhat egy szolgáltatásobjektumot, amely a 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 Név 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 lekérünk egy, a WMI szolgáltatást képviselő objektumot, és tároljuk Get-Service a $s változóban. Ezután elindítjuk a szolgáltatást. A PassThru paraméter Start-Service nélkül 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 le van tiltva.

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 le van tiltva. A Set-Service parancsmag manuálisra módosítja az indítási típust. 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 következőt Get-Service: .

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Megadja az elindítandó szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Megadja a parancsmag által kihagyott szolgáltatásokat. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Include

Megadja azokat a szolgáltatásokat, amelyeket ez a parancsmag elindít. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például s*. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Megadja az elindítandó szolgáltatás szolgáltatásneveit.

A paraméter neve nem kötelező. Használhatja a Nevet vagy annak aliasát, a ServiceName nevet, vagy kihagyhatja a paraméter nevét.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

A szolgáltatást jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

ServiceController

A szolgáltatásobjektumot erre a parancsmagra csövezheti.

String

Erre a parancsmagra a szolgáltatásnevet tartalmazó sztringet csövezheti.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

ServiceController

A PassThru paraméter használatakor ez a parancsmag a szolgáltatást képviselő ServiceController-objektumot adja vissza.

Jegyzetek

A PowerShell a következő aliasokat Start-Servicetartalmazza:

  • Windows:
    • sasv

Ez a parancsmag csak Windows-platformokon érhető el.

  • Start-Service csak 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 következőt Get-Service: . A szolgáltatásnevek a Név oszlopban, a megjelenített 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-Service parancs az üzenettel Cannot start service \<service-name\> on computermeghiúsul, Get-CimInstance keresse meg a szolgáltatás indítási típusát, és ha kell, a Set-Service parancsmaggal 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 szolgáltatást, amely szinte azonnal leáll, a következő üzenet jelenik meg: Service \<display-name\> start failed.