Remove-Service
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 mit dem Namen TestService entfernt. Der Befehl verwendet Get-Service
, um ein Objekt abzurufen, das den TestService-Dienst mithilfe des Anzeigenamens darstellt. Der Pipelineoperator (|
) weist das Objekt auf Remove-Service
, das den Dienst entfernt.
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 enthält keine Auflistungen. Wenn eine Auflistung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Sammlungen arbeiten, führen Sie die Eingabe aus, 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
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
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 ".