Share via

Restart-Service

  • Referentie
Module:
Microsoft.PowerShell.Management

Stopt en start vervolgens een of meer services.

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Restart-Service cmdlet verzendt een stopbericht en vervolgens een startbericht naar de Windows-servicecontroller voor een opgegeven service. Als een service al is gestopt, wordt deze gestart zonder u op de hoogte te stellen van een fout. U kunt de services opgeven met hun servicenamen of weergavenamen, of u kunt de parameter InputObject gebruiken om een object door te geven dat elke service vertegenwoordigt die u opnieuw wilt starten.

Voorbeelden

Voorbeeld 1: Een service opnieuw starten op de lokale computer

PS C:\> Restart-Service -Name winmgmt

Met deze opdracht start u de Windows Management Instrumentation-service (WinMgmt) opnieuw op de lokale computer.

Voorbeeld 2: Een service uitsluiten

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

Met deze opdracht worden de services opnieuw gestart die een weergavenaam hebben die begint met Net, met uitzondering van de Net-aanmeldingsservice.

Voorbeeld 3: Alle gestopte netwerkservices starten

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

Met deze opdracht worden alle gestopte netwerkservices op de computer gestart.

Met deze opdracht wordt de Get-Service cmdlet gebruikt om objecten op te halen die de services vertegenwoordigen waarvan de servicenaam begint met net. De pijplijnoperator (|) verzendt het servicesobject naar de Where-Object cmdlet, die alleen de services selecteert met de status Gestopt. Een andere pijplijnoperator verzendt de geselecteerde services naar Restart-Service.

In de praktijk gebruikt u de parameter WhatIf om het effect van de opdracht te bepalen voordat u deze uitvoert.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DisplayName

Hiermee geeft u de weergavenamen op van services die opnieuw moeten worden opgestart. Jokertekens zijn toegestaan.

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

-Exclude

Hiermee geeft u services op die door deze cmdlet worden weggelaten. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of -patroon in, zoals s*. Jokertekens zijn toegestaan.

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

-Force

Hiermee wordt de opdracht uitgevoerd zonder dat om bevestiging van de gebruiker wordt gevraagd.

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

-Include

Hiermee geeft u de services op die met deze cmdlet opnieuw worden gestart. De waarde van deze parameter komt in aanmerking voor de parameter Name . Voer een naamelement of -patroon in, zoals s*. Jokertekens zijn toegestaan.

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

-InputObject

Hiermee geeft u ServiceController-objecten op die de services vertegenwoordigen die opnieuw moeten worden opgestart. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

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

-Name

Hiermee geeft u de servicenamen op van de services die opnieuw moeten worden opgestart.

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

-PassThru

Retourneert een object dat de service vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

System.ServiceProcess.ServiceController, System.String

U kunt een serviceobject of een tekenreeks met een servicenaam doorspezen naar deze cmdlet.

Uitvoerwaarden

None, System.ServiceProcess.ServiceController

Deze cmdlet genereert een System.ServiceProcess.ServiceController-object dat de opnieuw gestarte service vertegenwoordigt, als u de parameter PassThru opgeeft. Anders genereert deze cmdlet geen uitvoer.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

  • Restart-Service kan services alleen beheren wanneer de huidige gebruiker hiertoe gemachtigd is. Als een opdracht niet goed werkt, beschikt u mogelijk niet over de vereiste machtigingen.
  • Als u de servicenamen en weergavenamen van de services op uw systeem wilt vinden, typt u Get-Service'. De servicenamen worden weergegeven in de kolom Naam en de weergavenamen worden weergegeven in de kolom DisplayName .