Restart-Service
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
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.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisplayName
Megadja az újraindítandó szolgáltatások megjelenítendő nevét. A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | ServiceController[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja az újraindítandó szolgáltatások szolgáltatásneveit.
Típus: | String[] |
Aliasok: | ServiceName |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-PassThru
A szolgáltatást jelképező objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A szolgáltatásobjektumot erre a parancsmagra csövezheti.
Erre a parancsmagra egy szolgáltatásnevet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A PassThru paraméter használatakor ez a parancsmag egy ServiceController objektumot ad vissza, amely az újraindított szolgáltatást jelöli.
Jegyzetek
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.