Restart-Service

Beendet einen oder mehrere Dienste und startet diese anschließend.

Syntax

Restart-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Restart-Service" werden für einen angegebenen Dienst eine Stoppmeldung und eine Startmeldung an den Windows-Dienstcontroller gesendet. Wenn ein Dienst bereits beendet wurde, wird er gestartet, ohne dass ein Fehler ausgegeben wird. Sie können die Dienste mit ihrem Dienstnamen oder Anzeigenamen angeben, oder Sie können mit dem InputObject-Parameter ein Objekt übergeben, das die einzelnen neu zu startenden Dienste darstellt.

Parameter

-DisplayName <string[]>

Gibt die Anzeigenamen der neu zu startenden Dienste an. Platzhalter sind zulässig.

Erforderlich?	true
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Exclude <string[]>

Lässt die angegebenen Dienste aus. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Force

Überschreibt Einschränkungen, die eine erfolgreiche Ausführung des Befehls verhindern, vorausgesetzt, dass dadurch die Sicherheit nicht gefährdet wird. Mit "Force" wird beispielsweise ein Dienst beendet und neu gestartet, der über abhängige Dienste verfügt.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Include <string[]>

Startet nur die angegebenen Dienste neu. Der Name-Parameter wird durch den Wert dieses Parameters qualifiziert. Geben Sie ein Namenselement oder -muster wie "s*" ein. Platzhalter sind zulässig.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-InputObject <ServiceController[]>

Gibt ServiceController-Objekte an, die die neu zu startenden Dienste darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	true (ByValue)
Platzhalterzeichen akzeptieren?	false

-Name <string[]>

Gibt die Dienstnamen der neu zu startenden Dienste an.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingaben akzeptieren?	true (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-PassThru

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

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm

Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WhatIf

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben	System.ServiceProcess.ServiceController, System.String Sie können ein Dienstobjekt oder eine Zeichenfolge, die einen Dienstnamen enthält, über die Pipeline an Restart-Service übergeben.
Ausgaben	Keiner oder System.ServiceProcess.ServiceController Wenn Sie den PassThru-Parameter verwenden, generiert Restart-Service ein System.ServiceProcess.ServiceController-Objekt, das den neu gestarteten Dienst darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

Mit Restart-Service können nur dann Dienste gesteuert werden, wenn der aktuelle Benutzer über die entsprechende Berechtigung verfügt. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.

Geben Sie "Get-Service" ein, um die Dienstnamen und die Anzeigenamen der Dienste auf dem System zu suchen. Die Dienstnamen werden in der Spalte "Name" und die Anzeigenamen in der Spalte "DisplayName" aufgeführt.

Beispiel 1

C:\PS>restart-service wmi

Beschreibung
-----------
Mit diesem Befehl wird der WMI-Dienst (Windows Management Instrumentation, Windows-Verwaltungsinstrumentation) auf dem lokalen Computer neu gestartet.

Beispiel 2

C:\PS>restart-service -displayname net* -exclude "net logon"

Beschreibung
-----------
Mit diesem Befehl werden die Dienste neu gestartet, deren Anzeigename mit "Net" beginnt, mit Ausnahme des Diensts "Net Logon".

Beispiel 3

C:\PS>get-service net* | where-object {$_.Status -eq "Stopped"} | restart-service

Beschreibung
-----------
Mit diesem Befehl werden alle beendeten Netzwerkdienste auf dem Computer gestartet.

Mit dem Cmdlet "Get-Service" werden Objekte abgerufen, die die Dienste darstellen, deren Dienstname mit "net" beginnt. (Der optionale Name-Parametername wird weggelassen.) Der Pipelineoperator (|) sendet das Dienstobjekt zum Cmdlet "Where-Object", das nur die Dienste mit dem Status "stopped" auswählt. Ein anderer Pipelineoperator sendet die ausgewählten Dienste an Restart-Service. In der Praxis überprüfen Sie die Auswirkungen des Befehls mit dem WhatIf-Parameter, bevor Sie den Befehl verwenden.

Siehe auch

Konzepte

Start-Service
Stop-Service
Suspend-Service
Resume-Service
New-Service
Get-Service
Set-Service