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 nazw usług lub nazw wyświetlanych albo użyć parametru InputObject , aby przekazać obiekt usługi reprezentujący 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ę IIS Administracja na komputerze lokalnym. Ponieważ zatrzymanie tej usługi również zatrzymuje usługi zależne od usług IIS Administracja, najlepiej jest poprzedzić Stop-Service poleceniem, które wyświetla listę usług zależnych od usług IIS Administracja.

Pierwsze polecenie zawiera listę usług, które zależą od usług IIS Administracja. Używa Get-Service go do pobrania obiektu reprezentującego usługę IIS Administracja. Operator potoku (|) przekazuje wynik do Format-List polecenia cmdlet . Polecenie używa parametru Property parametru Format-List, aby wyświetlić tylko właściwości Name i DependentServices usługi.

Drugie polecenie zatrzymuje usługi IIS Administracja. Parametr Force jest wymagany do zatrzymania usługi, która ma usługi zależne. Polecenie używa parametru Confirm do żądania 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 zatrzymuje 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

-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 braku 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 żadnych danych wyjściowych.

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 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 programu 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ą w kolumnie DisplayName .