Stop-Service
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 Stoppnachricht an den Windows Service Controller für jede der angegebenen Dienste. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben oder 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 (|
) rohrt 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 beendet, die vom IISAdmin-Dienst abhängig sind, ist es am besten, vor einem Befehl zu stehen Stop-Service
, der die Dienste auflisten, die vom IISAdmin-Dienst abhängig sind.
Mit dem ersten Befehl werden die Dienste aufgelistet, die von %%amp;quot;IISAdmin%%amp;quot; abhängen. Es wird verwendet Get-Service
, um ein Objekt abzurufen, das den IISAdmin-Dienst darstellt. Der Pipelineoperator (|
) übergibt das Ergebnis an das Format-List
Cmdlet. Der Befehl verwendet den EigenschaftsparameterFormat-List
, um nur die Eigenschaften "Name" und "AbhängigServices" des Diensts auflisten zu können.
Mit dem zweiten Befehl wird der IISAdmin-Dienst beendet. Der Force-Parameter ist erforderlich, um einen Dienst zu beenden, der abhängige Dienste aufweist. Der Befehl verwendet den Parameter "Bestätigen ", um bestätigung vom Benutzer anzufordern, bevor er jeden Dienst beendet.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Gibt die Anzeigenamen der Dienste an, die beendet werden sollen. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Gibt Dienste an, die dieses Cmdlet auslässt. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Nameelement oder Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Erzwingt das Cmdlet, einen Dienst zu beenden, auch wenn dieser Dienst abhängige Dienste aufweist.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Gibt Dienste an, die dieses Cmdlet beendet. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Nameelement oder Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Gibt ServiceController-Objekte an, die die Dienste darstellen, die beendet werden sollen. 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.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt die Dienstnamen der Dienste an, die beendet werden sollen. Platzhalterzeichen sind zulässig.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoWait
Gibt an, dass dieses Cmdlet die Option "Keine Wartezeit" verwendet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
System.ServiceProcess.ServiceController, System.String
Sie können ein Dienstobjekt oder eine Zeichenfolge weiterleiten, die den Namen eines Diensts an dieses Cmdlet enthält.
Ausgaben
None, System.ServiceProcess.ServiceController
Dieses Cmdlet generiert ein System.ServiceProcess.ServiceController-Objekt , das den Dienst darstellt, wenn Sie den PassThru-Parameter verwenden. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Sie können sich auch auf seinen integrierten Alias, spsv, beziehenStop-Service
. Weitere Informationen finden Sie unter %%amp;quot;about_Aliases%%amp;quot;.
Stop-Service
kann Dienste nur steuern, wenn der aktuelle Benutzer die Berechtigung hat, 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 auf Ihrem System zu finden, geben Sie den Typ Get-Service
". Die Dienstnamen werden in der Spalte "Name " angezeigt, und die Anzeigenamen werden in der Spalte "DisplayName " angezeigt.