Share via

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. Der Befehl verwendet Get-Service , um mithilfe des Anzeigenamens ein Objekt abzurufen, das den TestService-Dienst darstellt. Der Pipelineoperator (|) leitet das -Objekt an Remove-Serviceweiter, wodurch 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 listet keine Auflistungen auf. Wenn eine Sammlung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Auflistungen arbeiten, übergeben Sie die Eingabe, um die Werte aufzulisten.

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

System.ServiceProcess.ServiceController, System.String

Sie können ein Dienstobjekt oder eine Zeichenfolge, die den Namen eines Diensts enthält, an dieses Cmdlet übergeben.

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 .