Dela via


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:

ServiceController[]

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-Service kan 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.