Stop-Service
Beendet ausgeführte Dienste.
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 für jeden der angegebenen Dienste eine Stoppnachricht an den Windows-Dienstcontroller. 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 (|) übergibt das Objekt über die Pipeline 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 voranzustellen, der die Dienste auflistet, die vom IISAdmin-Dienst abhängen.
Der erste Befehl listet die Dienste auf, die von IISAdmin abhängen. Er 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 Property-Parameter von Format-List, um nur die Name-Eigenschaft und die DependentServices-Eigenschaft 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: | ServiceController[] |
| 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
System.ServiceProcess.ServiceController, System.String
Sie können ein Dienstobjekt oder eine Zeichenfolge, die den Namen eines Diensts enthält, über die Pipeline an dieses Cmdlet übergeben.
Ausgaben
None, System.ServiceProcess.ServiceController
Dieses Cmdlet generiert ein System.ServiceProcess.ServiceController-Objekt , das den Dienst darstellt, wenn Sie den PassThru-Parameter verwenden. Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
Sie können sich auch über den integrierten Alias spsv auf Stop-Service beziehen. Weitere Informationen finden Sie unter about_Aliases.
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.