Stop-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Beendet ausgeführte Dienste.

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 Stop-Service Cmdlet sendet eine Stoppmeldung an den Windows Service Controller für jeden der angegebenen Dienste. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den InputObject-Parameter 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 -benachrichtigungen (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 Dienst %%amp;quot;Telnet%%amp;quot; auf dem lokalen Computer beendet. Der Befehl verwendet Get-Service , um ein Objekt abzurufen, das den Telnet-Dienst darstellt. Der Pipelineoperator (|) gibt das Objekt an Stop-Service, das den Dienst beendet.

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, einem Befehl voraus zu gehen Stop-Service , der die Dienste auflistet, die vom IISAdmin-Dienst abhängen.

Mit dem ersten Befehl werden die Dienste aufgelistet, die von %%amp;quot;IISAdmin%%amp;quot; abhängen. Es wird Get-Service verwendet, um ein Objekt abzurufen, das den IISAdmin-Dienst darstellt. Der Pipelineoperator (|) übergibt das Ergebnis an das Format-List Cmdlet. Der Befehl verwendet den Property-ParameterFormat-List, um nur die Eigenschaften Name und DependentServices des Diensts auflisten zu können.

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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. Platzhalterzeichen 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 Name-Parameter . Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Platzhalterzeichen 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 Name-Parameter . Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Platzhalterzeichen 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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.

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. Platzhalterzeichen 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 wird von diesem Cmdlet keine Ausgabe generiert.

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

-WhatIf

Zeigt, was geschieht, 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:

  • Windows:
    • spsv

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

Stop-Service kann Dienste nur steuern, wenn der aktuelle Benutzer über die Berechtigung verfügt, dies zu tun. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.

Um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden, geben Sie folgendes ein Get-Service. Die Dienstnamen werden in der Spalte "Name " angezeigt, und die Anzeigenamen werden in der Spalte "DisplayName " angezeigt.