Share via

Stop-Service

  • Referentie
Module:
Microsoft.PowerShell.Management

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

System.ServiceProcess.ServiceController, System.String

U kunt een serviceobject of een tekenreeks met de naam van een service doorspezen naar deze cmdlet.

Uitvoerwaarden

None, System.ServiceProcess.ServiceController

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

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

U kunt ook verwijzen naar Stop-Service door de ingebouwde alias , spsv. Zie about_Aliases voor meer informatie.

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 .