Dela via

Stop-Service

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

InputObject (Standard) 

Stop-Service
    [-InputObject] <ServiceController[]>
    [-Force]
    [-NoWait]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Stop-Service
    [-Name] <String[]>
    [-Force]
    [-NoWait]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName 

Stop-Service
    -DisplayName <String[]>
    [-Force]
    [-NoWait]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Stop-Service skickar ett stoppmeddelande till Windows Service Controller 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. Den använder Get-Service för att hämta ett objekt som representerar IISAdmin-tjänsten. Pipelineoperatorn (|) skickar resultatet till cmdleten Format-List. Kommandot använder parametern property för Format-List för att endast visa egenskaperna Name och DependentServices för tjänsten.

Det andra kommandot stoppar IISAdmin-tjänsten. Parametern Force krävs för att stoppa en tjänst som har beroende tjänster. Kommandot använder parametern Confirm 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DisplayName

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

DisplayName
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Exclude

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Include

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-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.

Parameteregenskaper

Typ:

ServiceController[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InputObject
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:Tjänstenamn

Parameteruppsättningar

Default
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NoWait

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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

  • Windows:
    • spsv

Den här cmdleten är endast tillgänglig på Windows-plattformar.

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.