Restart-Service

Modul:

Microsoft.PowerShell.Management Module

Beendet Dienste und startet diese anschließend.

Syntax

InputObject (Standardwert)

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das cmdlet Restart-Service sendet eine Stoppmeldung und dann eine Startnachricht an den Windows Service Controller für einen bestimmten Dienst. Wenn ein Dienst bereits beendet wurde, wird er gestartet, ohne Sie über einen Fehler zu benachrichtigen. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben, oder Sie können den parameter InputObject verwenden, um ein Objekt zu übergeben, das jeden Dienst darstellt, den Sie neu starten möchten.

Beispiele

Beispiel 1: Neustarten eines Diensts auf dem lokalen Computer

PS C:\> Restart-Service -Name winmgmt

Mit diesem Befehl wird der Windows-Verwaltungsinstrumentationsdienst (WinMgmt) auf dem lokalen Computer neu gestartet.

Beispiel 2: Ausschließen eines Diensts

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

Mit diesem Befehl werden die Dienste neu gestartet, die einen Anzeigenamen aufweisen, der mit Net beginnt, mit Ausnahme des Net-Anmeldediensts.

Beispiel 3: Starten aller beendeten Netzwerkdienste

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

Dieser Befehl startet alle angehaltenen Netzwerkdienste auf dem Computer.

Dieser Befehl verwendet das Cmdlet Get-Service, um Objekte abzurufen, die die Dienste darstellen, deren Dienstname mit net beginnt. Der Pipelineoperator (|) sendet das Dienstobjekt an das cmdlet Where-Object, das nur die Dienste auswählt, die einen Status des Beendens aufweisen. Ein anderer Pipelineoperator sendet die ausgewählten Dienste an Restart-Service.

In der Praxis würden Sie den WhatIf Parameter verwenden, um den Effekt des Befehls zu bestimmen, bevor Sie ihn ausführen.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DisplayName

Gibt die Anzeigenamen der dienste an, die neu gestartet werden sollen. Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

DisplayName

Position:	Named
Obligatorisch.:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Exclude

Gibt Dienste an, die von diesem Cmdlet weggelassen werden. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Include

Gibt Dienste an, die dieses Cmdlet neu startet. Der Wert dieses Parameters qualifiziert den parameter Name. Geben Sie ein Namenselement oder ein Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-InputObject

Gibt ServiceController- Objekte an, die die Dienste darstellen, die neu gestartet werden sollen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der die Objekte ermittelt.

Parametereigenschaften

Typ:	ServiceController[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

InputObject

Position:	0
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Name

Gibt die Dienstnamen der dienste an, die neu gestartet werden sollen.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	True
Nicht anzeigen:	False
Aliase:	Dienstname

Parametersätze

Default

Position:	0
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-PassThru

Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

ServiceController

Sie können ein Dienstobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge, die einen Dienstnamen enthält, an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

ServiceController

Wenn Sie den parameter PassThru verwenden, gibt dieses Cmdlet ein ServiceController--Objekt zurück, das den neu gestarteten Dienst darstellt.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

• Restart-Service kann Dienste nur steuern, wenn der aktuelle Benutzer die Berechtigung dazu hat. Wenn ein Befehl nicht ordnungsgemäß funktioniert, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen.
• Um die Dienstnamen und Anzeigenamen der Dienste in Ihrem System zu finden, geben Sie Get-Service" ein. Die Dienstnamen werden in der Spalte Name angezeigt, und die Anzeigenamen werden in der Spalte DisplayName angezeigt.

Ähnliche Themen

• Get-Service
• Neuer Dienst
• Lebenslauf-Service
• Set-Service
• Start-Service
• Dienst stoppen
• Suspend-Service
• Remove-Service