Stop-Service
Hiermee stopt u een of meer actieve services.
Syntax
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Deze cmdlet is alleen beschikbaar op het Windows-platform.
De Stop-Service
cmdlet verzendt een stopbericht naar de Windows-servicecontroller voor elk van de opgegeven services. U kunt de services opgeven met hun servicenamen of weergavenamen, of u kunt de parameter InputObject gebruiken om een serviceobject door te geven dat de service vertegenwoordigt die u wilt stoppen.
Voorbeelden
Voorbeeld 1: Een service stoppen op de lokale computer
PS C:\> Stop-Service -Name "sysmonlog"
Met deze opdracht wordt de service Prestatielogboeken en -waarschuwingen (SysmonLog) op de lokale computer gestopt.
Voorbeeld 2: een service stoppen met behulp van de weergavenaam
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Met deze opdracht wordt de Telnet-service op de lokale computer gestopt. De opdracht gebruikt Get-Service
om een object op te halen dat de Telnet-service vertegenwoordigt. De pijplijnoperator (|
) leidt het object door naar Stop-Service
, waardoor de service wordt gestopt.
Voorbeeld 3: Een service stoppen die afhankelijke services heeft
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
In dit voorbeeld wordt de IISAdmin-service op de lokale computer gestopt. Omdat het stoppen van deze service ook de services stopt die afhankelijk zijn van de IISAdmin-service, kunt u het beste voorafgaan Stop-Service
door een opdracht die de services weergeeft die afhankelijk zijn van de IISAdmin-service.
Met de eerste opdracht worden de services weergegeven die afhankelijk zijn van IISAdmin. Deze gebruikt Get-Service
om een object op te halen dat de IISAdmin-service vertegenwoordigt. De pijplijnoperator (|
) geeft het resultaat door aan de Format-List
cmdlet. De opdracht gebruikt de parameter Eigenschap van Format-List
om alleen de eigenschappen Name en DependentServices van de service weer te geven.
De tweede opdracht stopt de IISAdmin-service. De parameter Force is vereist om een service te stoppen die afhankelijke services heeft. De opdracht gebruikt de parameter Confirm om bevestiging van de gebruiker te vragen voordat elke service wordt gestopt.
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 de services die moeten worden gestopt. 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
Dwingt de cmdlet om een service te stoppen, zelfs als die service afhankelijke services heeft.
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 worden gestopt. 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 moeten worden gestopt. 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 moeten worden gestopt. Jokertekens zijn toegestaan.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoWait
Geeft aan dat deze cmdlet de optie geen wachttijd gebruikt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 doorsnijden naar deze cmdlet.
U kunt een tekenreeks met de naam van een service doorsnijden 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 service vertegenwoordigt.
Notities
PowerShell bevat de volgende aliassen voor Stop-Service
:
- Windows:
spsv
Deze cmdlet is alleen beschikbaar op Windows-platforms.
Stop-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 Name en de weergavenamen in de kolom DisplayName .