Stop-Service
Beendet mindestens einen ausgeführten Dienst.
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>]
Beschreibung
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 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 (|) leitet das Objekt an Stop-Serviceweiter, wodurch der Service 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 Dienstes auch die Dienste stoppt, die vom IISAdmin-Dienst abhängen, empfiehlt es sich, Stop-Service einen Befehl voranzustellen, 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 aufzulisten.
Der zweite Befehl beendet den IISAdmin-Dienst. Der parameter Force ist erforderlich, um einen Dienst mit abhängigen Diensten zu beenden. Der Befehl verwendet den Confirm Parameter, um eine Bestätigung des Benutzers anzufordern, bevor jeder Dienst beendet wird.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DisplayName
Gibt die Anzeigenamen der dienste an, die beendet werden sollen. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
DisplayName
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-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*. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Erzwingt das Cmdlet, einen Dienst zu beenden, auch wenn dieser Dienst über abhängige Dienste verfügt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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*. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-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 ermittelt.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InputObject
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt die Dienstnamen der dienste an, die beendet werden sollen. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
| Aliase: | Dienstname |
Parametersätze
Default
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-NoWait
Gibt an, dass dieses Cmdlet die Option "Keine Wartezeit" verwendet.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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
Windows PowerShell enthält die folgenden Aliase für Stop-Service:
spsv
Stop-Service kann Dienste nur steuern, wenn der aktuelle Benutzer die Berechtigung dazu hat. 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.
