Sdílet prostřednictvím

Restart-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntaxe

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

Rutina Restart-Service odešle zprávu stop a potom zprávu start 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 restartování služby.

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 rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayName

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

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

Typ:ServiceController[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String[]
Aliasy:ServiceName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.ServiceProcess.ServiceController, System.String

Objekt služby nebo řetězec, který obsahuje název služby, můžete do této rutiny přeskakovat.

Výstupy

None, System.ServiceProcess.ServiceController

Tato rutina vygeneruje System.ServiceProcess.ServiceController objekt, který představuje restartovanou službu, pokud zadáte parametr PassThru. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • 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í.
  • Chcete-li najít názvy služeb a zobrazované názvy služeb v systému, zadejte Get-Service". Názvy služeb se zobrazí ve sloupci Název a zobrazované názvy se zobrazí ve sloupci DisplayName.