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 Stop-Service cmdlet 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 ich 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 polecenia do pobrania obiektu reprezentującego usługę Telnet. Operator potoku (|) potokuje obiekt do Stop-Serviceobiektu , 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 poleceniem, które wyświetla listę usług zależnych od usługi IISAdmin.

Pierwsze polecenie wyświetla listę usług, które zależą od usług IISAdmin. Używa Get-Service go do pobrania obiektu reprezentującego usługę IISAdmin. Operator potoku (|) przekazuje wynik do Format-List polecenia cmdlet. Polecenie używa parametru Property polecenia , Format-List aby wyświetlić listę tylko właściwości Name i DependentServices 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 , aby zażądać potwierdzenia od użytkownika przed zatrzymanie każdej usługi.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-NoWait

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Zwraca obiekt reprezentujący usługę. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

ServiceController

Do tego polecenia cmdlet można przekazać obiekt usługi.

String

Możesz przekazać potok ciągu zawierającego 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-Serviceprogramu :

  • W systemie Windows:
    • spsv

To polecenie cmdlet jest dostępne tylko na platformach systemu 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 .