Freigeben über


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