Restart-Service

  • Reference
Modul:
Microsoft.PowerShell.Management

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

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

Rutina Restart-Service odešle zprávu zastavení 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 pomocí parametru 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 pomocí rutiny Get-Service získá objekty, které představují služby, jejichž název služby začíná na net. Operátor kanálu (|) odešle objekt služeb do Where-Object rutiny, 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 parametr WhatIf k určení efektu příkazu před jeho spuštěním.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

-PassThru

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

ServiceController

Objekt služby můžete do této rutiny převést.

String

Do této rutiny můžete zamísit řetězec, který obsahuje 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

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