Share via

Stop-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

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 Stoppmeldung an den Windows-Dienstcontroller für jeden der angegebenen Dienste. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können 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 (|) leitet das -Objekt an weiter, Stop-Servicewodurch 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 beendet, die vom IISAdmin-Dienst abhängen, empfiehlt es sich, einem Befehl voraus zu gehen Stop-Service , der die vom IISAdmin-Dienst abhängigen Dienste auflistet.

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 Property-Parameter von, Format-List um nur die Name - und DependentServices-Eigenschaften des Diensts aufzulisten.

Mit dem zweiten Befehl wird der IISAdmin-Dienst beendet. Der Force-Parameter ist erforderlich, um einen Dienst mit abhängigen Diensten zu beenden. Der Befehl verwendet den Confirm-Parameter , um eine 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 zu beendenden Dienste an. 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 Parameter Name . Geben Sie ein Name-Element 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 über abhängige Dienste verfügt.

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 Parameter Name . Geben Sie ein Name-Element 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 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.

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 ohne 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, die den Namen eines Diensts enthält, an dieses Cmdlet weiterleiten.

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 auch auf den Stop-Service integrierten Alias spsv verweisen. Weitere Informationen finden Sie unter %%amp;quot;about_Aliases%%amp;quot;.

Stop-Service kann Dienste nur steuern, wenn der aktuelle Benutzer dazu über die Berechtigung verfügt. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.

Geben Sie ein, Get-Serviceum die Dienst- und Anzeigenamen der Dienste auf Ihrem System zu suchen. Die Dienstnamen werden in der Spalte Name und die Anzeigenamen in der Spalte DisplayName angezeigt.