Startet das Betriebssystem auf lokalen und Remote-Computern neu.
- Syntax
- Beschreibung
- Beispiele
- Beispiel 1: Starten Sie den lokalen Computer neu
- Beispiel 2: Starten Sie mehrere Computer neu
- Beispiel 3: Computernamen aus einer Textdatei abrufen
- Beispiel 4: Neustart der in einer Textdatei aufgeführten Computer erzwingen
- Beispiel 6: Starten Sie einen Remotecomputer neu und warten Sie, bis PowerShell
- Beispiel 7: Starten Sie einen Computer mithilfe von WsmanAuthentication neu
- Parameter
- Inputs
- Outputs
- Hinweise
Syntax
Beschreibung
Das Restart-Computer Cmdlet startet das Betriebssystem auf den lokalen und Remote-Computern neu.
Sie können die Parameter von Restart-Computerverwenden, um die Neustartvorgänge auszuführen, die Authentifizierungsstufen und alternative Anmeldeinformationen anzugeben, die gleichzeitig ausgeführten Vorgänge einzuschränken und einen sofortigen Neustart zu erzwingen.
Ab Windows PowerShell 3.0 können Sie warten, bis der Neustart abgeschlossen ist, bevor Sie den nextcommand ausführen. Geben Sie eine Wartezeit und ein Abfrageintervall an und warten Sie, bis bestimmte Dienste auf dem neu gestarteten Computer verfügbar sind. Diese Funktion macht es praktisch, Restart-Computer Inskripte und Funktionen zu verwenden.
Beispiele
Beispiel 1: Starten Sie den lokalen Computer neu
Restart-Computer startet den lokalen Computer neu.
Restart-ComputerBeispiel 2: Starten Sie mehrere Computer neu
Restart-Computer kann Remote- und lokale Computer neu starten. Der Parameter ComputerName akzeptiert ein Array von Computernamen.
Restart-Computer -ComputerName Server01, Server02, localhostBeispiel 3: Computernamen aus einer Textdatei abrufen
Restart-Computer Ruft eine Liste von Computernamen aus einer Textdatei ab und startet die Computer neu. Der Parameter TheComputerName ist nicht angegeben. Da es sich jedoch um den ersten Positionsparameter handelt, werden die Computernamen aus der Textdatei akzeptiert, die in der Pipeline gesendet werden.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content verwendet den Parameter Path, um eine Liste der Computernamen aus einer Textdatei, Domain01, abzurufen.txt. Die Computernamen werden in der Pipeline gesendet. Restart-Computer startet jeden Computer neu.
Beispiel 4: Neustart der in einer Textdatei aufgeführten Computer erzwingen
Dieses Beispiel erzwingt einen sofortigen Neustart der in der Domain01.txt -Datei aufgeführten Computer. Die Computernamen aus der Textdatei werden in einer Variablen gespeichert. Der Force-Parameter erzwingt den Neustart von animmediate.
Get-Content verwendet den Parameter Path, um eine Liste von Computernamen aus einer Textdatei, Domain01, abzurufen.txt. Die Computernamen werden in der Variablen $Names gespeichert. Get-Credential fordert Sie zur Eingabe eines Benutzernamens und Passworts auf und speichert die Werte in der Variablen $CredsRestart-Computerverwendet die Parameter ComputerName und Credential mit ihren Variablen. Der Forceparameter bewirkt einen sofortigen Neustart jedes Computers.
Beispiel 6: Starten Sie einen Remotecomputer neu und warten Sie, bis PowerShell
Restart-Computer startet den Remotecomputer neu und wartet dann bis zu 5 Minuten (300 Sekunden), bis PowerShell auf dem neu gestarteten Computer verfügbar ist, bevor der Vorgang fortgesetzt wird.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer verwendet den Parameter ComputerName, um Server01 anzugeben. Der Waitparameter wartet, bis der Neustart abgeschlossen ist. Das For gibt an, dass PowerShell Befehle ausführen kannder Remotecomputer. Der Timeout-Parameter gibt eine Wartezeit von fünf Minuten an. Der Parameter Delay fragt den Remotecomputer alle zwei Sekunden ab, um festzustellen, ob er neu gestartet wurde.
Beispiel 7: Starten Sie einen Computer mithilfe von WsmanAuthentication neu
Restart-Computer Startet den Remotecomputer mithilfe des WsmanAuthentication-Mechanismus neu.Die Kerberos-Authentifizierung bestimmt, ob der aktuelle Benutzer über die Berechtigung zum Neustart des Remotecomputers verfügt. Weitere Informationen finden Sie unterauthenticationmechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer verwendet den Parameter ComputerName, um den Remotecomputer Server01 anzugeben.Der Parameter WsmanAuthentication gibt die Authentifizierungsmethode als Kerberos an.
Parameter
Gibt einen Computernamen oder ein kommagetrenntes Array von Computernamen an. Restart-Computer acceptsComputerName Objekte aus der Pipeline oder Variablen.
Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen eines Remotecomputers ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt . oder localhost ein.
Dieser Parameter ist nicht auf PowerShell-Remoting angewiesen. Sie können den Parameter ComputerName auch dann verwenden, wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.
Wenn der Parameter ComputerName nicht angegeben ist, Restart-Computer startet den lokalen Computer neu.
| Typ: | String |
| Aliase: | CN, __SERVER, Server, IP-Adresse |
| Position: | 0 |
| Standardwert: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, das vom Get-Credential-Cmdlet generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, thepassword einzugeben.
Anmeldeinformationen werden in einem PSCredentialobject und das Kennwort als SecureString gespeichert.
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. PowerShell fragt den im Parameter Service angegebenen Dienst ab, um festzustellen, ob der Dienst nach dem Neustart des Computers verfügbar ist.
Dieser Parameter ist nur zusammen mit den Parametern Wait und For gültig.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
Wenn der Parameter Delay nicht angegeben ist, verwendet Restart-Computer eine Verzögerung von fünf Sekunden.
| Typ: | Int16 |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Gibt das Verhalten von PowerShell an, das darauf wartet, dass der angegebene Dienst oder die angegebene Funktion nach dem Neustart des Computers verfügbar wird. Dieser Parameter ist nur mit dem Parameter Wait gültig.
Die zulässigen Werte für diesen Parameter sind:
- Standard: Wartet auf den Neustart von PowerShell.
- PowerShell: Kann Befehle in einer PowerShell-Remotesitzung auf dem Computer ausführen.
- WMI: Empfängt eine Antwort auf eine Win32_ComputerSystem-Abfrage für den Computer.
- WinRM: Kann mit WS-Management eine Remote-Sitzung auf dem Computer einrichten.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Typ: | WaitForServiceTypes |
| Akzeptierte Werte: | Wmi, WinRM, PowerShell |
| Position: | Named |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. Nach Ablauf der Zeitüberschreitung kehrt Restart-Computer zur Eingabeaufforderung zurück, auch wenn die Computer nicht neu gestartet werden.
Der Timeout-Parameter ist nur mit dem Wait-Parameter gültig. Timeout überschreibt die unbestimmte Wartezeit des Parameters Wait.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Typ: | Int32 |
| Aliase: | TimeoutSec |
| Position: | Benannt |
| Standardwert: | Keine |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Restart-Computer unterdrückt die PowerShell-Eingabeaufforderung und blockiert die Pipeline, bis die Computer neu gestartet wurden. Sie können diesen Parameter in einem Skript verwenden, um Computer neu zu starten und die Verarbeitung fortzusetzen, wenn der Neustart abgeschlossen ist.
Der Parameter Wait wartet unbegrenzt auf den Neustart der Computer. Sie können Timeout verwenden, um das Timing sowie die Parameter For und Delay anzupassen und zu warten, bis bestimmte Dienste auf den neu gestarteten Computern verfügbar werden.
Der Parameter Wait ist ungültig, wenn Sie den lokalen Computer neu starten. Wenn der Wert desComputerName-Parameters die Namen der Remotecomputer und des lokalen Computers enthält,generiertRestart-Computer einen nicht abschließenden Fehler für Wait auf dem lokalen Computer, aber waitsfür den Neustart der Remotecomputer.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Standardwert: | False |
| Pipeline-Eingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Gibt den Mechanismus an, der zur Authentifizierung der Benutzeranmeldeinformationen verwendet wird. Dieser Parameter wasintroduced in Windows Powershell 3.0.
Die zulässigen Werte für diesen Parameter sind: Basic, CredSSP, Default, Digest,Kerberos und Negotiate.
Weitere Informationen finden Sie unterauthenticationmechanism.
Warnung
CredSSP-Authentifizierung (Credential Security Service Provider), bei der die Benutzeranmeldeinformationen zur Authentifizierung an einen Remotecomputer übergeben werden, ist für Befehle vorgesehen, für die eine Authentifizierung für mehr als eine Ressource erforderlich ist, z. B. für den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remote-Betriebs. Wenn der Remotecomputer kompromittiert ist, derkredentiale, die an ihn übergeben werden, können zur Steuerung der Netzwerksitzung verwendet werden.
| Typ: | String |
| Akzeptierte Werte: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
Hinweise
- In Windows verwendet
Restart-Computerdie Win32Shutdown-Methode der Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Für diese Methode muss das SeShutdownPrivilege-Privileg für das Benutzerkonto aktiviert sein, das zum Neustart des Computers verwendet wird. - Unter Linux und Mac OS verwendet
Restart-Computerdas/sbin/shutdownBash-Tool.
- Informationen zur Windows-Remoteverwaltung
- Get-Credential
- WS-Verwaltungsprotokoll