Freigeben über

Stop-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Beendet mindestens einen ausgeführten Dienst.

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Cmdlet Stop-Service sendet eine Stoppmeldung für jeden der angegebenen Dienste an den Windows Service Controller. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den parameter InputObject verwenden, um ein Dienstobjekt zu übergeben, das den Dienst darstellt, den Sie beenden möchten.

Beispiele

Beispiel 1: Beenden eines Diensts auf dem lokalen Computer

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

Mit diesem Befehl wird der Dienst Für Leistungsprotokolle und Warnungen (SysmonLog) auf dem lokalen Computer beendet.

Beispiel 2: Beenden eines Diensts mithilfe des Anzeigenamens

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

Mit diesem Befehl wird der Telnet-Dienst auf dem lokalen Computer beendet. Der Befehl verwendet Get-Service, um ein Objekt abzurufen, das den Telnet-Dienst darstellt. Der Pipelineoperator (|) rohrt das Objekt an Stop-Service, wodurch der Dienst beendet wird.

Beispiel 3: Beenden eines Diensts mit abhängigen Diensten

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

In diesem Beispiel wird der IISAdmin-Dienst auf dem lokalen Computer beendet. Da das Beenden dieses Diensts auch die Dienste stoppt, die vom IISAdmin-Dienst abhängen, empfiehlt es sich, Stop-Service einen Befehl zu stellen, der die Dienste auflistet, die vom IISAdmin-Dienst abhängen.

Der erste Befehl listet die Dienste auf, die von IISAdmin abhängen. Es verwendet Get-Service, um ein Objekt abzurufen, das den IISAdmin-Dienst darstellt. Der Pipelineoperator (|) übergibt das Ergebnis an das cmdlet Format-List. Der Befehl verwendet den parameter Property von Format-List, um nur die eigenschaften Name und DependentServices des Diensts auflisten.

Der zweite Befehl beendet den IISAdmin-Dienst. Der parameter Force ist erforderlich, um einen Dienst mit abhängigen Diensten zu beenden. Der Befehl verwendet die Confirm Parameter, um eine Bestätigung des Benutzers anzufordern, bevor jeder Dienst beendet wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt die Anzeigenamen der dienste an, die beendet werden sollen. Wildcardzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Exclude

Gibt Dienste an, die von diesem Cmdlet weggelassen werden. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Wildcardzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Force

Erzwingt das Cmdlet, einen Dienst zu beenden, auch wenn dieser Dienst über abhängige Dienste verfügt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Include

Gibt Dienste an, die dieses Cmdlet beendet. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Wildcardzeichen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-InputObject

Gibt ServiceController- Objekte an, die die zu beendenden Dienste darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte abruft.

Typ:ServiceController[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Dienstnamen der dienste an, die beendet werden sollen. Wildcardzeichen sind zulässig.

Typ:String[]
Aliase:ServiceName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-NoWait

Gibt an, dass dieses Cmdlet die Option "Keine Wartezeit" verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge mit dem Namen eines Diensts an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

ServiceController

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein ServiceController- Objekt zurück, das den Dienst darstellt.

Hinweise

PowerShell enthält die folgenden Aliase für Stop-Service:

  • Fenster:
    • spsv

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Stop-Service können Dienste nur steuern, wenn der aktuelle Benutzer über die Berechtigung verfügt, dies zu tun. Wenn ein Befehl nicht ordnungsgemäß funktioniert, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen.

Geben Sie Get-Serviceein, um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden. Die Dienstnamen werden in der Spalte Name angezeigt, und die Anzeigenamen werden in der Spalte DisplayName angezeigt.