Restart-Service
Beendet Dienste und startet diese anschließend.
Syntax
Restart-Service
[-Force]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Restart-Service
[-Force]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Restart-Service
Cmdlet sendet eine Stoppnachricht und dann eine Startnachricht an den Windows-Dienstcontroller für einen angegebenen Dienst. Wenn ein Dienst bereits beendet wurde, wird er gestartet, ohne dass ein Fehler ausgegeben wird. Sie können die Dienste anhand ihrer Dienstnamen oder Anzeigenamen angeben oder den InputObject-Parameter verwenden, um ein Objekt zu übergeben, das jeden Dienst darstellt, den Sie neu starten möchten.
Beispiele
Beispiel 1: Starten eines Diensts auf dem lokalen Computer neu
PS C:\> Restart-Service -Name winmgmt
Mit diesem Befehl wird der WMI-Dienst (WinMgmt) auf dem lokalen Computer neu gestartet.
Beispiel 2: Ausschließen eines Diensts
PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"
Dieser Befehl startet die Dienste neu, die einen Anzeigenamen haben, der mit Net beginnt, außer für den Net-Anmeldedienst.
Beispiel 3: Starten aller beendeten Netzwerkdienste
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Mit diesem Befehl werden alle beendeten Netzwerkdienste auf dem Computer gestartet.
Dieser Befehl verwendet das Get-Service
Cmdlet, um Objekte abzurufen, die die Dienste darstellen, deren Dienstname mit net beginnt. Der Pipelineoperator (|
) sendet das Diensteobjekt an das Where-Object
Cmdlet, das nur die Dienste auswählt, die einen Status des Stopps haben. 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 es ausführen.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Gibt die Anzeigenamen von Diensten an, die neu gestartet werden sollen. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Gibt Dienste an, die dieses Cmdlet auslässt. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Nameelement oder Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Gibt Dienste an, die dieses Cmdlet neu startet. Der Wert dieses Parameters qualifiziert den Name-Parameter . Geben Sie ein Nameelement oder Muster ein, z. B. s*. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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 einen Ausdruck ein, mit dem die Objekte abgerufen werden.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt die Dienstnamen der dienste an, die neu gestartet werden sollen.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Gibt ein Objekt zurück, das den Dienst darstellt. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
System.ServiceProcess.ServiceController, System.String
Sie können ein Dienstobjekt oder eine Zeichenfolge weiterleiten, die einen Dienstnamen an dieses Cmdlet enthält.
Ausgaben
None, System.ServiceProcess.ServiceController
Dieses Cmdlet generiert ein System.ServiceProcess.ServiceController-Objekt , das den neu gestarteten Dienst darstellt, wenn Sie den PassThru-Parameter angeben. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Restart-Service
kann Dienste nur steuern, wenn der aktuelle Benutzer die Berechtigung hat, dies zu tun. Wenn ein Befehl nicht ordnungsgemäß verarbeitet wird, verfügen Sie u. U. nicht über die erforderlichen Berechtigungen.- Um die Dienstnamen und Anzeigenamen der Dienste auf Ihrem System zu finden, geben Sie
Get-Service
". Die Dienstnamen werden in der Spalte "Name " angezeigt, und die Anzeigenamen werden in der Spalte "DisplayName " angezeigt.