Restart-Service
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 beginbericht 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 op basis van 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 opstarten.
Voorbeelden
Voorbeeld 1: Een service opnieuw opstarten op de lokale computer
PS C:\> Restart-Service -Name winmgmt
Met deze opdracht wordt de Windows Management Instrumentation-service (WinMgmt) opnieuw opgestart 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 netaanmeldingsservice.
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, waarmee alleen de services worden geselecteerd die de status Gestopt hebben. 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 van services die opnieuw moeten worden gestart. 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 deze cmdlet weglaat. 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 dwingt u de opdracht uit te voeren zonder dat u 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 services op die door deze cmdlet opnieuw worden opgestart. 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 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
U kunt een serviceobject doorsluisen naar deze cmdlet.
U kunt een tekenreeks met een servicenaam doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert standaard geen uitvoer.
Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een ServiceController-object dat de opnieuw gestarte service vertegenwoordigt.
Notities
Deze cmdlet is alleen beschikbaar op Windows-platforms.
Restart-Service
kan services alleen beheren wanneer de huidige gebruiker hiervoor gemachtigd is. Als een opdracht niet goed werkt, hebt u mogelijk niet 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 .
Verwante koppelingen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor