Restart-Service

  • Referencia
Modul:
Microsoft.PowerShell.Management

Leállítja, majd elindít egy vagy több szolgáltatást.

Syntax

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

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

A Restart-Service parancsmag egy leállítási üzenetet, majd egy indítási üzenetet küld egy adott szolgáltatás Windows-szolgáltatásvezérlőjének. Ha egy szolgáltatás már le lett állítva, a hiba értesítése nélkül indul el. Megadhatja a szolgáltatásokat a szolgáltatásnevek vagy megjelenítendő nevek alapján, vagy az InputObject paraméter használatával átadhat egy objektumot, amely minden újraindítani kívánt szolgáltatást jelöl.

Példák

1. példa: Szolgáltatás újraindítása a helyi számítógépen

PS C:\> Restart-Service -Name winmgmt

Ez a parancs újraindítja a Windows Management Instrumentation szolgáltatást (WinMgmt) a helyi számítógépen.

2. példa: Szolgáltatás kizárása

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

Ez a parancs újraindítja azokat a szolgáltatásokat, amelyek megjelenítendő neve a Net-lel kezdődik, kivéve a Net Bejelentkezési szolgáltatást.

3. példa: Az összes leállított hálózati szolgáltatás indítása

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

Ez a parancs elindítja az összes leállított hálózati szolgáltatást a számítógépen.

Ez a parancs a Get-Service parancsmaggal lekéri azokat a szolgáltatásokat képviselő objektumokat, amelyeknek a szolgáltatásneve nettel kezdődik. A folyamatkezelő (|) elküldi a szolgáltatásobjektumot a Where-Object parancsmagnak, amely csak a leállított állapotú szolgáltatásokat választja ki. Egy másik folyamatüzemeltető elküldi a kijelölt szolgáltatásokat a következőnek Restart-Service: .

A gyakorlatban a WhatIf paraméter használatával határozná meg a parancs hatását a futtatás előtt.

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 újraindí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

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

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

-Include

Megadja azokat a szolgáltatásokat, amelyeket ez a parancsmag újraindí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 újraindí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 újraindítandó szolgáltatások szolgáltatásneveit.

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

-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 egy szolgáltatásnevet tartalmazó sztringet csövezhet.

Kimenetek

None

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

ServiceController

A PassThru paraméter használatakor ez a parancsmag egy ServiceController objektumot ad vissza, amely az újraindított szolgáltatást jelöli.

Jegyzetek

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

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