Stoppt einen oder mehrere laufende Dienste.
Syntax
Stop-Service <ServiceController> >] >] Stop-Service <String> >] >] Stop-Service -DisplayName <String> >] >] Beschreibung
Das Cmdlet Stop-Service sendet für jeden der angegebenen Dienste eine Stoppmeldung 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 stoppen möchten.
Beispiele
Beispiel 1: Beenden eines Dienstes auf dem lokalen Computer
PS C:\> Stop-Service -Name "sysmonlog"Dieser Befehl stoppt den Dienst SysmonLog (Performance Logs and Alerts) auf dem lokalen Computer.
Beispiel 2: Beenden eines Dienstes mit dem Anzeigenamen
PS C:\> Get-Service -DisplayName "telnet" | Stop-ServiceDieser Befehl stoppt den Telnet-Dienst auf dem lokalen Computer. Der Befehl verwendet Get-Service, um zu erhaltenein Objekt, das den Telnet-Dienst darstellt. Der Pipeline-Operator (|) leitet das Objekt an Stop-Service weiter, wodurch der Dienst beendet wird.
Beispiel 3: Beenden eines Dienstes mit abhängigen Diensten
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServicesPS C:\> Stop-Service -Name "iisadmin" -Force -ConfirmIn diesem Beispiel wird der IISAdmin-Dienst auf dem lokalen Computer beendet. Da das Stoppen dieses Dienstes auch die Dienste beendet, die vom IISAdmin-Dienst abhängen, ist es am besten, vor Stop-Service einen Befehl zu setzen, 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 Pipeline-Operator (|) übergibt das Ergebnis an das CmdletFormat-List. Der Befehl verwendet den Eigenschaftsparameter Format-List, um nur die Eigenschaften Name und DependentServices des Dienstes aufzulisten.
Der zweite Befehl beendet den IISAdmin-Dienst. Der Force-Parameter ist erforderlich, um einen Dienst zu stoppen, der abhängige Dienste hat. Der Befehl verwendet den Parameter Confirm, um eine Bestätigung anzufordernder Benutzer, bevor er jeden Dienst stoppt.
Parameter
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
| Typ: | SwitchParameter |
| Aliase: | vgl |
| Position: | Benannt |
| Standardwert: | False |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Gibt die Anzeigenamen der zu stoppenden Dienste an.Platzhalterzeichen sind zulässig.
| Typ: | String |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | Falsch |
| Platzhalterzeichen akzeptieren: | True |
Gibt Dienste an, die dieses Cmdlet auslässt. Der Wert dieses Parameters qualifiziert den Nameparameter. Geben Sie ein Namenselement oder -muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
| Typ: | String |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | Wahr |
Erzwingt, dass das Cmdlet einen Dienst stoppt, auch wenn dieser Dienst abhängige Dienste hat.
| Typ: | SwitchParameter |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Gibt Dienste an, die dieses Cmdlet stoppt. Der Wert dieses Parameters qualifiziert den Nameparameter. Geben Sie ein Namenselement oder -muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
| Typ: | String |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
Gibt ServiceController-Objekte an, die die zu stoppenden 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: | Keine |
| Pipeline-Eingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Gibt die Dienstnamen der zu stoppenden Dienste an. Platzhalterzeichen sind zulässig.
| Typ: | Zeichenkette |
| Aliase: | ServiceName |
| Position: | 0 |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | True |
Gibt an, dass dieses Cmdlet die Option no wait verwendet.
| Typ: | SwitchParameter |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | Falsch |
Zeigt an, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Benannt |
| Standardwert: | False |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingänge
System.ServiceProzess.ServiceController, System.String
Sie können ein Dienstobjekt oder eine Zeichenfolge, die den Namen eines Dienstes enthält, über die Pipeline an dieses Cmdlet übergeben.
Ausgänge
Keine, System.ServiceProzess.ServiceController
Dieses Cmdlet generiert ein System.ServiceProzess.ServiceController-Objekt, das die darstelltservice, wenn Sie den Parameter PassThru verwenden. Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Sie können auch auf Stop-Service über den integrierten Alias spsv verweisen. Weitere Informationen finden Sie unterabout_aliases.
Stop-Service kann Dienste nur steuern, wenn der aktuelle Benutzer dazu berechtigt ist. Wenn acommand nicht ordnungsgemäß funktioniert, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen.
Geben Sie Get-Serviceein, um die Dienstnamen und Anzeigenamen der Dienste auf Ihrem System zu ermitteln. Die Servicenamen werden in der Spalte Name und die Anzeigenamen in der Spalte DisplayNamecolumn angezeigt.
- Get-Dienst
- Neuer Dienst
- Restart-Dienst
- Resume-Dienst
- Set-Dienst
- Start-Dienst
- Suspend-Dienst
- Remove-Dienst