Restart-Service

Modul:

Microsoft.PowerShell.Management Module

Zastaví a pak spustí jednu nebo více služeb.

Syntaxe

InputObject (Výchozí)

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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Restart-Service odešle zprávu zastavení a pak zprávu o spuštění do kontroleru služeb systému Windows pro zadanou službu. Pokud už byla služba zastavená, spustí se bez upozornění na chybu. Služby můžete zadat podle jejich názvů služeb nebo zobrazované názvy, nebo můžete použít parametr InputObject předat objekt, který představuje každou službu, kterou chcete restartovat.

Příklady

Příklad 1: Restartování služby v místním počítači

PS C:\> Restart-Service -Name winmgmt

Tento příkaz restartuje službu Windows Management Instrumentation (WinMgmt) v místním počítači.

Příklad 2: Vyloučení služby

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

Tento příkaz restartuje služby, které mají zobrazovaný název začínající platformou Net, s výjimkou služby Net Logon.

Příklad 3: Spuštění všech zastavených síťových služeb

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

Tento příkaz spustí všechny zastavené síťové služby v počítači.

Tento příkaz používá rutinu Get-Service k získání objektů, které představují služby, jejichž název služby začíná net. Operátor kanálu (|) odešle objekt služeb do rutiny Where-Object, která vybere pouze služby, které mají stav zastaveno. Jiný operátor kanálu odešle vybrané služby do Restart-Service.

V praxi byste použili WhatIf parametr k určení efektu příkazu před jeho spuštěním.

Parametry

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DisplayName

Určuje zobrazované názvy služeb, které se mají restartovat. Jsou povoleny zástupné znaky.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

DisplayName

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Exclude

Určuje služby, které tato rutina vynechá. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Include

Určuje služby, které se tato rutina restartuje. Hodnota tohoto parametru kvalifikuje parametr Name. Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné znaky.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Určuje ServiceController objekty, které představují služby, které se mají restartovat. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.

Vlastnosti parametru

Typ:	ServiceController[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

InputObject

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje názvy služeb, které se mají restartovat.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False
Aliasy:	Název služby

Sady parametrů

Default

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PassThru

Vrátí objekt, který představuje službu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

ServiceController

Objekt služby můžete předat tomuto cmdletu.

String

Do tohoto příkazu můžete předat řetězec obsahující název služby.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

ServiceController

Pokud použijete parametr PassThru, vrátí tato rutina objekt ServiceController představující restartovanou službu.

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

• Restart-Service může řídit služby pouze v případě, že má aktuální uživatel oprávnění k tomu. Pokud příkaz nefunguje správně, možná nemáte požadovaná oprávnění.
• Pokud chcete najít názvy služeb a zobrazované názvy služeb ve vašem systému, zadejte Get-Service". Názvy služeb se zobrazí ve sloupci Název a zobrazované názvy se zobrazí ve sloupci DisplayName.

Související odkazy

• Get-Service
• Nová služba
• Obnovení služby
• Set-Service
• Start-Service
• Zastavit službu
• Pozastavit službu
• Odstranit službu