Restart-Service
Zatrzymuje się, a następnie uruchamia co najmniej jedną usługę.
Składnia
InputObject (Domyślna)
Restart-Service
[-InputObject] <ServiceController[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Restart-Service
[-Name] <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Restart-Service
-DisplayName <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Ten cmdlet jest dostępny tylko na platformie Windows.
Polecenie cmdlet Restart-Service 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 Get-Service do pobierania obiektów reprezentujących usługi, których nazwa usługi rozpoczyna się od net. Operator potoku (|) wysyła obiekt usług do polecenia cmdlet Where-Object, które wybiera tylko usługi, które mają stan zatrzymany. Inny operator potoku wysyła wybrane usługi do Restart-Service.
W praktyce należy użyć parametru WhatIf, aby określić efekt polecenia przed jego uruchomieniem.
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DisplayName
Określa nazwy wyświetlane usług do ponownego uruchomienia. Symbole wieloznaczne są dozwolone.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
DisplayName
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Exclude
Określa usługi pomijane przez to polecenie cmdlet. Wartość tego parametru kwalifikuje parametr Name. Wprowadź element nazwy lub wzorzec, taki jak s*. Symbole wieloznaczne są dozwolone.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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*. Symbole wieloznaczne są dozwolone.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa ServiceController obiektów reprezentujących usługi do ponownego uruchomienia. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
InputObject
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwy usług do ponownego uruchomienia.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
| Aliasy: | Nazwa usługi |
Zestawy parametrów
Default
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący usługę. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
ServiceController
Do tego polecenia cmdlet można przekazać obiekt usługi.
String
Możesz przekazywać ciąg zawierający nazwę usługi do tego cmdletu.
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
Ten cmdlet jest dostępny tylko na platformach Windows.
-
Restart-Servicemoż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.
