Freigeben über

Remove-Service

  • Referenz
Modul:
Microsoft.PowerShell.Management

Entfernt einen Windows-Dienst.

Syntax

Remove-Service
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Service
      [-InputObject <ServiceController>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das cmdlet Remove-Service entfernt einen Windows-Dienst in der Registrierung und in der Dienstdatenbank.

Das cmdlet Remove-Service wurde in PowerShell 6.0 eingeführt.

Beispiele

Beispiel 1: Entfernen eines Diensts

Dadurch wird ein Dienst namens TestService entfernt.

Remove-Service -Name "TestService"

Beispiel 2: Entfernen eines Diensts mithilfe des Anzeigenamens

In diesem Beispiel wird ein Dienst namens TestService entfernt. Der Befehl verwendet Get-Service, um ein Objekt abzurufen, das den TestService-Dienst mithilfe des Anzeigenamens darstellt. Der Pipelineoperator (|) rohrt das Objekt an Remove-Service, wodurch der Dienst entfernt wird.

Get-Service -DisplayName "Test Service" | Remove-Service

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ServiceController- Objekte an, die die zu entfernenden Dienste darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte abruft.

Der InputObject--Parameter aufzählt keine Auflistungen. Wenn eine Auflistung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Sammlungen arbeiten, führen Sie die Eingabe weiter, um die Werte aufzählen zu können.

Typ:ServiceController
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Dienstnamen der zu entfernenden Dienste an. Wildcardzeichen sind zulässig.

Typ:String
Aliase:ServiceName, SN
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge mit dem Namen eines Diensts an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Um dieses Cmdlet auszuführen, starten Sie PowerShell mithilfe der Option Als Administrator ausführen.