Udostępnij za pośrednictwem

Stop-Service

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Zatrzymuje co najmniej jedną uruchomioną usługę.

Składnia

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie cmdlet Stop-Service wysyła komunikat zatrzymania do kontrolera usługi systemu Windows dla każdej z określonych usług. Możesz określić usługi według nazw usług lub nazw wyświetlanych albo użyć parametru InputObject, aby przekazać obiekt usługi, który reprezentuje usługę, którą chcesz zatrzymać.

Przykłady

Przykład 1. Zatrzymywanie usługi na komputerze lokalnym

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

To polecenie zatrzymuje usługę Dzienniki wydajności i alerty (SysmonLog) na komputerze lokalnym.

Przykład 2. Zatrzymywanie usługi przy użyciu nazwy wyświetlanej

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

To polecenie zatrzymuje usługę Telnet na komputerze lokalnym. Polecenie używa Get-Service, aby uzyskać obiekt reprezentujący usługę Telnet. Operator potoku (|) potokuje obiekt w celu Stop-Service, który zatrzymuje usługę.

Przykład 3. Zatrzymywanie usługi, która ma usługi zależne

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

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

Pierwsze polecenie wyświetla listę usług, które zależą od iisAdmin. Używa Get-Service, aby uzyskać obiekt reprezentujący usługę IISAdmin. Operator potoku (|) przekazuje wynik do polecenia cmdlet Format-List. Polecenie używa parametru PropertyFormat-List do wyświetlania listy tylko właściwości Name i DependentServices właściwości usługi.

Drugie polecenie zatrzymuje usługę IISAdmin. Parametr Force jest wymagany do zatrzymania usługi, która ma usługi zależne. Polecenie używa parametru Confirm w celu żądania potwierdzenia od użytkownika przed zatrzymanie każdej usługi.

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

-DisplayName

Określa nazwy wyświetlane usług do zatrzymania. Dozwolone są symbole wieloznaczne.

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

-Exclude

Określa usługi pomijane przez to polecenie cmdlet. Wartość tego parametru kwalifikuje parametr Name. Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są symbole wieloznaczne.

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

-Force

Wymusza zatrzymanie usługi przez polecenie cmdlet, nawet jeśli ta usługa ma usługi zależne.

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

-Include

Określa usługi, które zatrzymuje to polecenie cmdlet. Wartość tego parametru kwalifikuje parametr Name. Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są symbole wieloznaczne.

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

-InputObject

Określa ServiceController obiektów reprezentujących usługi do zatrzymania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

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

-Name

Określa nazwy usług do zatrzymania. Dozwolone są symbole wieloznaczne.

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

-NoWait

Wskazuje, że to polecenie cmdlet używa opcji braku oczekiwania.

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

-PassThru

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

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

ServiceController

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt ServiceController reprezentujący usługę.

Uwagi

Program PowerShell zawiera następujące aliasy dla Stop-Service:

  • Windows:
    • spsv

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

Stop-Service może kontrolować usługi tylko wtedy, gdy bieżący użytkownik ma uprawnienia do tego. Jeśli polecenie nie działa poprawnie, być może nie masz wymaganych uprawnień.

Aby znaleźć nazwy usług i nazwy wyświetlane usług w systemie, wpisz Get-Service. Nazwy usług są wyświetlane w kolumnie Nazwa, a nazwy wyświetlane są wyświetlane w kolumnie DisplayName.