Restart-Service
Stoppar och startar sedan en eller flera tjänster.
Syntax
InputObject (Standard)
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>]
Description
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Restart-Service skickar ett stoppmeddelande och sedan ett startmeddelande till Windows Service Controller för en angiven tjänst. Om en tjänst redan har stoppats startas den utan att du meddelas om något fel. Du kan ange tjänsterna efter deras tjänstnamn eller visningsnamn, eller så kan du använda parametern InputObject för att skicka ett objekt som representerar varje tjänst som du vill starta om.
Exempel
Exempel 1: Starta om en tjänst på den lokala datorn
PS C:\> Restart-Service -Name winmgmt
Det här kommandot startar om Tjänsten Windows Management Instrumentation (WinMgmt) på den lokala datorn.
Exempel 2: Exkludera en tjänst
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"
Det här kommandot startar om de tjänster som har ett visningsnamn som börjar med Net, förutom tjänsten Net-inloggning.
Exempel 3: Starta alla stoppade nätverkstjänster
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Det här kommandot startar alla stoppade nätverkstjänster på datorn.
Det här kommandot använder cmdleten Get-Service för att hämta objekt som representerar de tjänster vars tjänstnamn börjar med net. Pipelineoperatorn (|) skickar tjänstobjektet till cmdleten Where-Object, som endast väljer de tjänster som har statusen stoppad. En annan pipelineoperator skickar de valda tjänsterna till Restart-Service.
I praktiken använder du parametern WhatIf för att fastställa effekten av kommandot innan du kör det.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-DisplayName
Anger visningsnamnen för de tjänster som ska startas om. Jokertecken tillåts.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
DisplayName
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Exclude
Anger tjänster som denna cmdlet utelämnar. Värdet för den här parametern kvalificerar parametern Name. Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Include
Anger tjänster som den här cmdleten startar om. Värdet för den här parametern kvalificerar parametern Name. Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-InputObject
Anger ServiceController objekt som representerar de tjänster som ska startas om. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
InputObject
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Name
Anger tjänstnamnen för de tjänster som ska startas om.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
| Alias: | Tjänstenamn |
Parameteruppsättningar
Default
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-PassThru
Returnerar ett objekt som representerar tjänsten. Som standard genererar den här cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
ServiceController
Du kan skicka ett tjänstobjekt till den här cmdleten.
String
Du kan skicka en sträng som innehåller ett tjänstnamn till den här cmdleten.
Utdata
None
Som standard returnerar den här cmdleten inga utdata.
ServiceController
När du använder parametern PassThru returnerar den här cmdleten ett ServiceController--objekt som representerar den omstartade tjänsten.
Kommentarer
Den här cmdleten är endast tillgänglig på Windows-plattformar.
-
Restart-Servicekan endast styra tjänster när den aktuella användaren har behörighet att göra detta. Om ett kommando inte fungerar korrekt kanske du inte har de behörigheter som krävs. - Om du vill hitta tjänstnamnen och visningsnamnen för tjänsterna i systemet skriver du
Get-Service". Tjänstnamnen visas i kolumnen Namn och visningsnamnen visas i kolumnen DisplayName.