Udostępnij za pośrednictwem

Restart-Service

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

Zatrzymuje się, a następnie uruchamia co najmniej jedną usługę.

Składnia

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

Opis

Polecenie Restart-Service cmdlet wysyła komunikat zatrzymania, a następnie komunikat początkowy do kontrolera usługi systemu Windows dla określonej usługi. Jeśli usługa została już zatrzymana, jest uruchamiana bez powiadamiania o błędzie. Możesz określić usługi według nazw usług lub nazw wyświetlanych albo użyć parametru InputObject , aby przekazać obiekt reprezentujący każdą usługę, którą chcesz ponownie uruchomić.

Przykłady

Przykład 1. Ponowne uruchamianie usługi na komputerze lokalnym

PS C:\> Restart-Service -Name winmgmt

To polecenie uruchamia ponownie usługę Instrumentacji zarządzania Windows (WinMgmt) na komputerze lokalnym.

Przykład 2. Wykluczanie usługi

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

To polecenie uruchamia ponownie usługi, które mają nazwę wyświetlaną rozpoczynającą się od Net, z wyjątkiem usługi Net Logon.

Przykład 3. Uruchamianie wszystkich zatrzymanych usług sieciowych

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

To polecenie uruchamia wszystkie zatrzymane usługi sieciowe na komputerze.

To polecenie używa polecenia cmdlet do pobierania Get-Service obiektów reprezentujących usługi, których nazwa usługi zaczyna się od net. Operator potoku (|) wysyła obiekt usług do Where-Object polecenia cmdlet, które wybiera tylko usługi, które mają stan zatrzymany. Inny operator potoku wysyła wybrane usługi do usługi Restart-Service.

W praktyce należy użyć parametru WhatIf , aby określić efekt polecenia przed jego uruchomieniem.

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 ponownego uruchomienia. 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 uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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 to polecenie cmdlet uruchamia ponownie. 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 obiekty ServiceController reprezentujące usługi do ponownego uruchomienia. 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 ponownego uruchomienia.

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

-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 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

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 ponownie uruchomioną usługę.

Uwagi

  • Restart-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 .