Beendet einen oder mehrere ausgeführte Dienste.
Syntax
Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>] Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>] Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Stop-Service" wird für jeden der angegebenen Dienste eine Stoppmeldung an den Windows-Dienstcontroller gesendet. Sie können die Dienste mit ihren Dienstnamen oder Anzeigenamen angeben, oder Sie können mit dem InputObject-Parameter ein Dienstobjekt übergeben, das die zu beendenden Dienste darstellt.
Parameter
-DisplayName <string[]>
Gibt die Anzeigenamen der zu beendenden Dienste an. Platzhalter sind zulässig.
|
Erforderlich? |
true |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Exclude <string[]>
Lässt die angegebenen Dienste aus. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Ermöglicht dem Cmdlet das Beenden eines Diensts, auch wenn dieser Dienst über abhängige Dienste verfügt.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Include <string[]>
Beendet nur die angegebenen Dienste. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-InputObject <ServiceController[]>
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.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt die Dienstnamen der zu beendenden Dienste an. Platzhalter sind zulässig.
Der Parametername ist optional. Sie können "Name" oder den zugehörigen Alias "ServiceName" verwenden oder aber den Parameternamen auslassen.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-PassThru
Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.ServiceProcess.ServiceController oder System.String Sie können ein Dienstobjekt oder eine Zeichenfolge, die einen Dienstnamen enthält, über die Pipeline an Stop-Service übergeben. |
|
Ausgaben |
Keiner oder System.ServiceProcess.ServiceController Wenn Sie den PassThru-Parameter verwenden, generiert Stop-Service ein System.ServiceProcess.ServiceController-Objekt, das den Dienst darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Hinweise
Sie können auch über den integrierten Alias "spsv" auf Stop-Service verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Mit Stop-Service können nur dann Dienste gesteuert werden, wenn der aktuelle Benutzer über die entsprechende Berechtigung verfügt. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.
Geben Sie "Get-Service" ein, um die Dienstnamen und die Anzeigenamen der Dienste auf dem System zu suchen. Die Dienstnamen werden in der Spalte "Name" und die Anzeigenamen in der Spalte "DisplayName" aufgeführt.
Beispiel 1
C:\PS>stop-service sysmonlog Beschreibung ----------- Mit diesem Befehl wird der Dienst für Leistungsprotokolle und -benachrichtigungen (SysmonLog) auf dem lokalen Computer beendet.
Beispiel 2
C:\PS>get-service -displayname telnet | stop-service Beschreibung ----------- Mit diesem Befehl wird der Dienst "Telnet" auf dem lokalen Computer beendet. Der Befehl ruft mit dem Cmdlet "Get-Service" ein Objekt ab, das den Telnet-Dienst darstellt. Mit dem Pipelineoperator (|) wird das Objekt über die Pipeline an das Cmdlet "Stop-Service" übergeben, wodurch der Dienst beendet wird.
Beispiel 3
C:\PS>get-service iisadmin | format-list -property name, dependentservices C:PS>stop-service iisadmin -force -confirm Beschreibung ----------- Mit dem Befehl "Stop-Service" wird der IISAdmin-Dienst auf dem lokalen Computer beendet. Da durch das Beenden dieses Diensts auch die vom IISAdmin-Dienst abhängigen Dienste beendet werden, empfiehlt es sich, vor dem Befehl "Stop-Service" einen Befehl auszuführen, durch den die Dienste aufgelistet werden, die vom IISAdmin-Dienst abhängig sind. Mit dem ersten Befehl werden die Dienste aufgelistet, die von "IISAdmin" abhängen. Mit dem Cmdlet "Get-Service" wird ein Objekt abgerufen, 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 für den Dienst aufzulisten. Mit dem zweiten Befehl wird der IISAdmin-Dienst beendet. Der Force-Parameter ist erforderlich, wenn ein Dienst beendet werden soll, der über abhängige Dienste verfügt. Der Befehl fordert aufgrund des Confirm-Parameters vor dem Beenden der einzelnen Dienste eine Bestätigung des Benutzers an.
Siehe auch