Remove-Service
Usuwa usługę systemu Windows.
Składnia
Name (Domyślna)
Remove-Service
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Remove-Service
[-InputObject <ServiceController>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-Service usuwa usługę systemu Windows w rejestrze i w bazie danych usługi.
Polecenie cmdlet Remove-Service zostało wprowadzone w programie PowerShell 6.0.
Przykłady
Przykład 1. Usuwanie usługi
Spowoduje to usunięcie usługi o nazwie TestService.
Remove-Service -Name "TestService"
Przykład 2. Usuwanie usługi przy użyciu nazwy wyświetlanej
W tym przykładzie usunięto usługę o nazwie TestService. Polecenie używa Get-Service, aby uzyskać obiekt reprezentujący usługę TestService przy użyciu nazwy wyświetlanej. Operator potoku (|) potokuje obiekt w celu Remove-Service, który usuwa usługę.
Get-Service -DisplayName "Test Service" | Remove-Service
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa ServiceController obiektów reprezentujących usługi do usunięcia. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.
Parametr InputObject nie wylicza kolekcji. Jeśli kolekcja zostanie przekazana, zostanie zgłoszony błąd. Podczas pracy z kolekcjami należy przekazać dane wejściowe w celu wyliczenia wartości.
Właściwości parametru
| Typ: | ServiceController |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
InputObject
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwy usług do usunięcia. Symbole wieloznaczne są dozwolone.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
| Aliasy: | Nazwa usługi, SN |
Zestawy parametrów
Name
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
ServiceController
Do tego polecenia cmdlet można przekazać obiekt usługi.
String
Możesz potokować ciąg zawierający nazwę usługi do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Ten cmdlet jest dostępny tylko na platformach Windows.
Aby uruchomić to polecenie cmdlet, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator.