Remove-Service

Usuwa usługę systemu Windows.

Składnia

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

Opis

Polecenie Remove-Service cmdlet usuwa usługę systemu Windows w rejestrze i w bazie danych usługi.

Polecenie Remove-Service cmdlet 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 polecenia w celu pobrania obiektu reprezentującego usługę TestService przy użyciu nazwy wyświetlanej. Operator potoku (|) potokuje obiekt do Remove-Serviceobiektu , który usuwa usługę.

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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa obiekty ServiceController reprezentujące 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.

Typ:ServiceController
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwy usług do usunięcia. Dozwolone są symbole wieloznaczne.

Typ:String
Aliasy:ServiceName, SN
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

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

To polecenie cmdlet jest dostępne tylko na platformach windows.

Aby uruchomić to polecenie cmdlet, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator .