Stop-Service

Moduł: Microsoft.PowerShell.Zarządzanie

zatrzymuje jedną lub więcej uruchomionych usług.

składnia

Stop-Service <ServiceController> >] >] 
Stop-Service <String> >] >] 
Stop-Service -DisplayName <String> >] >] 

opis

polecenie polecenia Stop-Service wysyła wiadomość stop do kontrolera usług systemu Windows dla każdej z określonych usług. Możesz określić usługi według ich nazw usług lub nazw wyświetlanych, lub możesz użyć parametru InputObject, aby przekazać obiekt service reprezentujący usługę, którą chcesz zatrzymać.

przykłady

przykład 1: Zatrzymaj usługę na komputerze lokalnym

PS C:\> Stop-Service -Name "sysmonlog"

to polecenie zatrzymuje usługę dzienników wydajności i alertów (Sysmonlog) na komputerze lokalnym.

przykład 2: Zatrzymaj usługę używając wyświetlanej nazwy

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

to polecenie zatrzymuje usługę Telnet na komputerze lokalnym. Polecenie używa Get-Service do uzyskania obiektu reprezentującego usługę Telnet. Operator rurociągu (|) podłącza obiekt doStop-Service, co zatrzymuje usługę.

przykład 3: Zatrzymaj usługę, która ma usługi zależne

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServicesPS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

ten przykład zatrzymuje usługę IISAdmin na komputerze lokalnym. Ponieważ zatrzymanie tej usługi obejmuje również usługi, które zależą od usługi IISAdmin, najlepiej poprzedzić Stop-Service poleceniem, które wyświetla listę usług, które zależą od usługi IISAdmin.

pierwsze polecenie wyświetla listę usług zależnych od IISAdmin. Używa Get-Service, aby uzyskać obiekt, który reprezentuje usługę IISAdmin. Operator rurociągu (|) przekazuje wynik do poleceniaFormat-List. Polecenie wykorzystuje parametr Właściwości z Format-List do wyświetlenia tylko właściwości Name i DependentServices usługi.

drugie polecenie zatrzymuje usługę IISAdmin. Parametr Force jest wymagany do zatrzymania usług, które mają usługi zależne. Polecenie wykorzystuje parametr Confirm do żądania potwierdzenia od użytkownika, zanim zatrzyma każdą usługę.

parametry

-Potwierdź

monituje o potwierdzenie przed uruchomieniem cmdletu.

Typ: SwitchParameter
Aliasy: cf
pozycja: Nazwa
Wartość domyślna: False
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: False
-DisplayName

określa wyświetlane nazwy usług, które mają zostać zatrzymane.Dozwolone są znaki wieloznaczne.

Typ: String
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: True

-Exclude

określa usługi, które pomija ten cmdlet. Wartość tego parametru kwalifikuje Nameparametr. Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są znaki wieloznaczne.

Typ: String
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: True
-wymusza

wymusza polecenie polecenia do zatrzymania usługi, nawet jeśli ta usługa ma usługi zależne.

Typ: SwitchParameter
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: False
-Include

określa usługi, które ten cmdlet zatrzymuje. Wartość tego parametru kwalifikuje Nameparametr. Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są znaki wieloznaczne.

Typ: String
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: True
-InputObject

określa Obiekty ServiceController, które reprezentują zatrzymane usługi. Wprowadź zmienną, która zawiera obiekty, lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

Typ: ServiceController
Położenie: 0
Wartość domyślna: brak
Akceptuj wejście potoku: True
Akceptuj znaki wieloznaczne: False
-Nazwa

określa nazwy usług, które mają zostać zatrzymane. Dozwolone są znaki wieloznaczne.

Typ: String
aliasy:
Położenie: 0
Wartość domyślna: brak
Akceptuj wejście potoku: True
Akceptuj znaki wieloznaczne: True
-NoWait

wskazuje, że ten cmdlet używa opcji no wait.

Typ: SwitchParameter
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: False
-PassThru

zwraca obiekt reprezentujący usługę. Domyślnie ten cmdlet nie generuje żadnych danych wyjściowych.

Typ: SwitchParameter
pozycja: Nazwa
Wartość domyślna: brak
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: False
-WhatIf

pokazuje, co by się stało, gdyby polecenie cmdlet zostało uruchomione. Cmdlet nie jest uruchomiony.

Typ: SwitchParameter
aliasy: wi
pozycja: Nazwa
Wartość domyślna: False
Akceptuj wejście potoku: False
Akceptuj znaki wieloznaczne: False

wejścia

System.Proces serwisowy.ServiceController, System.String

do tego cmdletu można podłączyć obiekt service lub łańcuch zawierający nazwę usługi.

Wyjścia

Brak, System.Proces serwisowy.ServiceController

ten cmdlet generuje System.Proces serwisowy.Obiekt ServiceController, który reprezentuje theservice, jeśli użyjesz parametru PassThru. W przeciwnym razie, ten cmdlet nie generuje żadnych danych wyjściowych.

uwagi

ten cmdlet jest dostępny tylko na platformach Windows.

możesz również odwołać się do Stop-Service poprzez wbudowany alias, spsv. Aby uzyskać więcej informacji, zobaczabout_aliases.

Stop-Service może kontrolować usługi tylko wtedy, gdy bieżący użytkownik ma na to pozwolenie. Jeśli polecenie nie działa poprawnie, możesz nie mieć wymaganych uprawnień.

aby znaleźć nazwy usług i wyświetlane nazwy usług w systemie, wpisz Get-Service. Nazwy usług pojawiają się w kolumnie Nazwa, A nazwy wyświetlane w kolumnie DisplayNamecolumn.

  • Get-Service
  • New-Service
  • Restart-Service
  • Wznów-Service
  • Ustaw-Service
  • Start-Service
  • Zawieś-Service
  • Usuń-Serwis

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany.

More: