Restart-Service

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

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

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.

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

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

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

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

Uwagi

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

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