Restart-Service

Modul:

Microsoft.PowerShell.Management Module

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

Syntax

InputObject (Alapértelmezett)

Restart-Service
    [-InputObject] <ServiceController[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Restart-Service
    [-Name] <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName

Restart-Service
    -DisplayName <String[]>
    [-Force]
    [-PassThru]
    [-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 használhatja a InputObject paramétert egy olyan objektum átadásához, 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, amelyek szolgáltatásneve a 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 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

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

-Force

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

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

-Include

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

Megadja ServiceController objektumokat, amelyek az újraindítandó szolgáltatásokat jelölik. 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 újraindítandó szolgáltatások szolgáltatásneveit.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
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

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 szabályozhatja 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.

Kapcsolódó hivatkozások

• Get-Service
• Új szolgáltatás
• Önéletrajz-szolgáltatás
• Set-Service
• Start-Service
• Szolgáltatás leállítása
• Szolgáltatás felfüggesztése
• Szolgáltatás eltávolítása