Stop-Service

  • Referens
Modul:
Microsoft.PowerShell.Management

Stoppar en eller flera tjänster som körs.

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

Cmdleten Stop-Service skickar ett stoppmeddelande till Windows-tjänstkontrollanten för var och en av de angivna tjänsterna. Du kan ange tjänsterna efter tjänstnamn eller visningsnamn, eller så kan du använda parametern InputObject för att skicka ett tjänstobjekt som representerar den tjänst som du vill stoppa.

Exempel

Exempel 1: Stoppa en tjänst på den lokala datorn

PS C:\> Stop-Service -Name "sysmonlog"

Det här kommandot stoppar tjänsten Prestandaloggar och aviseringar (SysmonLog) på den lokala datorn.

Exempel 2: Stoppa en tjänst med visningsnamnet

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

Det här kommandot stoppar Telnet-tjänsten på den lokala datorn. Kommandot använder Get-Service för att hämta ett objekt som representerar Telnet-tjänsten. Pipelineoperatorn (|) skickar objektet till Stop-Service, vilket stoppar tjänsten.

Exempel 3: Stoppa en tjänst som har beroende tjänster

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

Det här exemplet stoppar IISAdmin-tjänsten på den lokala datorn. Eftersom stopp av den här tjänsten också stoppar de tjänster som är beroende av IISAdmin-tjänsten är det bäst att föregå Stop-Service med ett kommando som visar de tjänster som är beroende av IISAdmin-tjänsten.

Det första kommandot visar de tjänster som är beroende av IISAdmin. Det används Get-Service för att hämta ett objekt som representerar IISAdmin-tjänsten. Pipelineoperatorn (|) skickar resultatet till cmdleten Format-List . Kommandot använder egenskapsparametern Format-List för för att endast visa egenskaperna Name och DependentServices för tjänsten.

Det andra kommandot stoppar IISAdmin-tjänsten. Force-parametern krävs för att stoppa en tjänst som har beroende tjänster. Kommandot använder parametern Bekräfta för att begära bekräftelse från användaren innan den stoppar varje tjänst.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger visningsnamnen för de tjänster som ska stoppas. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Exclude

Anger tjänster som denna cmdlet utelämnar. Värdet för den här parametern kvalificerar parametern Namn . Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Force

Tvingar cmdleten att stoppa en tjänst även om tjänsten har beroende tjänster.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Include

Anger tjänster som den här cmdleten stoppar. Värdet för den här parametern kvalificerar parametern Namn . Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-InputObject

Anger ServiceController-objekt som representerar de tjänster som ska stoppas. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Typ:ServiceController[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger tjänstnamnen för de tjänster som ska stoppas. Jokertecken tillåts.

Typ:String[]
Alias:ServiceName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-NoWait

Anger att den här cmdleten använder alternativet ingen väntetid.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar tjänsten. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ServiceController

Du kan skicka ett tjänstobjekt till den här cmdleten.

String

Du kan skicka en sträng som innehåller namnet på en tjänst till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

ServiceController

När du använder parametern PassThru returnerar den här cmdleten ett ServiceController-objekt som representerar tjänsten.

Kommentarer

Windows PowerShell innehåller följande alias för Stop-Service:

  • spsv

Stop-Service kan endast styra tjänster när den aktuella användaren har behörighet att göra detta. Om ett kommando inte fungerar korrekt kanske du inte har de behörigheter som krävs.

Om du vill hitta tjänstnamnen och visningsnamnen för tjänsterna i systemet skriver du Get-Service. Tjänstnamnen visas i kolumnen Namn och visningsnamnen visas i kolumnen DisplayName .