Delen via

Stop-Service

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee stopt u een of meer actieve services.

Syntaxis

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 op basis van 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 stopt u de service Prestatielogboeken en -waarschuwingen (SysmonLog) op de lokale computer.

Voorbeeld 2: Een service stoppen met behulp van de weergavenaam

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

Met deze opdracht stopt u de Telnet-service op de lokale computer. De opdracht gebruikt Get-Service om een object op te halen dat de Telnet-service vertegenwoordigt. De pijplijnoperator (|) geeft het object door aan Stop-Service, waardoor de service wordt gestopt.

Voorbeeld 3: Een service met afhankelijke services stoppen

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 aan Stop-Service een opdracht waarin de services worden vermeld die afhankelijk zijn van de IISAdmin-service.

De eerste opdracht bevat de services die afhankelijk zijn van IISAdmin. Het 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 eigenschapsparameter om Format-List 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 met afhankelijke services te stoppen. De opdracht gebruikt de parameter Bevestigen om bevestiging van de gebruiker aan te vragen voordat elke service wordt gestopt.

Parameters

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenamen van de services die moeten worden gestopt. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Force

Dwingt de cmdlet af om een service te stoppen, zelfs als die service afhankelijke services heeft.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de servicenamen van de services die moeten worden gestopt. Jokertekens zijn toegestaan.

Type:String[]
Aliassen:ServiceName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-NoWait

Geeft aan dat deze cmdlet gebruikmaakt van de optie geen wachttijd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

ServiceController

U kunt een serviceobject doorsluisen naar deze cmdlet.

String

U kunt een tekenreeks met de naam van een service doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

ServiceController

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 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 Get-Serviceu . De servicenamen worden weergegeven in de kolom Naam en de weergavenamen worden weergegeven in de kolom DisplayName .