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 Remove-Service Cmdlet entfernt einen Windows-Dienst in der Registrierung und in der Dienstdatenbank.

Das Remove-Service-Cmdlet 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. Mit dem Befehl wird Get-Service ein Objekt abgerufen, das den TestService-Dienst mithilfe des Anzeigenamens darstellt. Der Pipelineoperator (|) weist das Objekt auf Remove-Service, in das der Dienst entfernt wird.

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

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

-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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Der InputObject-Parameter enumeriert 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.

Type:ServiceController
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ServiceName, SN
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-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

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".