Herstart het besturingssysteem op lokale en externe computers.
- syntaxis
- Description
- voorbeelden
- Voorbeeld 1: start de lokale computer opnieuw op
- Voorbeeld 2: meerdere computers herstarten
- Voorbeeld 3: computernamen ophalen uit een tekstbestand
- Voorbeeld 4: herstart forceren van computers in een tekstbestand
- Voorbeeld 6: Herstart een externe computer en wacht tot PowerShell
- Voorbeeld 7: Herstart een computer met behulp van WsmanAuthentication
- Parameters
- Inputs
- Outputs
- Notes
syntaxis
Description
de Restart-Computer cmdlet Start het besturingssysteem opnieuw op op lokale en externe computers.
u kunt de parameters van Restart-Computer gebruiken om de herstartbewerkingen uit te voeren, om de aanmeldingsniveaus en alternatieve referenties te specificeren, om de bewerkingen die tegelijkertijd worden uitgevoerd te beperken en om een onmiddellijke herstart te forceren.
vanaf Windows PowerShell 3.0 kunt u wachten tot de HERSTART is voltooid voordat u het nextcommand uitvoert. Geef een wachttijd en query-interval op en wacht tot bepaalde services beschikbaar zijn op de herstartcomputer. Deze functie maakt het praktisch om Restart-Computer inscripten en functies te gebruiken.
voorbeelden
Voorbeeld 1: start de lokale computer opnieuw op
Restart-Computer Herstart de lokale computer.
Restart-ComputerVoorbeeld 2: meerdere computers herstarten
Restart-Computer kan externe en lokale computers herstarten. De computernaam parameter accepteert anarray van computernamen.
Restart-Computer -ComputerName Server01, Server02, localhostVoorbeeld 3: computernamen ophalen uit een tekstbestand
Restart-Computer haalt een lijst met computernamen uit een tekstbestand en start de computers opnieuw op. De parameter computernaam is niet opgegeven. Maar omdat het de eerste positie parameter, itaccepteert de computer namen uit het tekstbestand dat naar beneden worden gestuurd de pijplijn.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content gebruikt de parameter Path om een lijst met computernamen te krijgen uit een tekstbestand,Domain01.txt. De computer namen worden naar de pijplijn gestuurd. Restart-Computer start elke computer opnieuw op.
Voorbeeld 4: herstart forceren van computers in een tekstbestand
dit voorbeeld forceert een onmiddellijke herstart van de computers in het Domain01.txt bestand. De computernamen uit het tekstbestand worden opgeslagen in een variabele. De parameter Force forces animmediate herstart.
Get-Content gebruikt de parameter Path om een lijst met computernamen te krijgen uit een tekstbestand,Domain01.txt. De computernamen worden opgeslagen in de variabele $NamesGet-Credential geeft u een gebruikersnaam en wachtwoord en slaat de waarden op in de variabele $CredsRestart-Computergebruikt de computernaam en Credential parameters met hun variabelen. De Forceparameter zorgt voor een onmiddellijke herstart van elke computer.
Voorbeeld 6: Herstart een externe computer en wacht tot PowerShell
Restart-Computer Herstart de externe computer en wacht vervolgens tot 5 minuten (300 seconden) totdat PowerShell beschikbaar is op de herstartende computer voordat deze verder gaat.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer gebruikt de computernaam parameter om Server01 te specificeren. De Wachtparameter wacht tot de HERSTART is voltooid. De For specificeert dat PowerShell opdrachten op de externe computer kan uitvoeren. De Timeout parameter specificeert een wachttijd van vijf minuten. De Vertragingsparameter vraagt de externe computer om de twee seconden om te bepalen of deze opnieuw is gestart.
Voorbeeld 7: Herstart een computer met behulp van WsmanAuthentication
Restart-Computer Herstart de externe computer met behulp van het wsmanauthentication mechanisme.Met Kerberos-verificatie wordt bepaald of de huidige gebruiker toestemming heeft om de remotecomputer opnieuw te starten. Voor meer informatie, zie authenticatiemechanisme.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer gebruikt de parameter computernaam om de externe computer Server01 op te geven.De parameter WsmanAuthentication specificeert de verificatiemethode als Kerberos.
Parameters
specificeert één computernaam of een door komma ‘ s gescheiden array van computernamen. Restart-Computer accepteert computernaam objecten uit de pijplijn of variabelen.
Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een externe computer. Om de lokale computer te specificeren, typt u de computernaam, een punt ., of localhost.
deze parameter is niet afhankelijk van PowerShell remoting. U kunt de parameter computernaam ook gebruiken als uw computer niet is geconfigureerd om externe opdrachten uit te voeren.
als de parameter computernaam niet is opgegeven, start Restart-Computer de lokale computer opnieuw op.
| Type: | String | aliassen: | CN, _ _ SERVER, Server, ipadres | positie: | 0 | standaardwaarde: | 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 |
specificeert een gebruikersaccount met rechten om deze actie uit te voeren. De standaard is de huidige gebruiker.
Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential object in dat wordt gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om hetwachtwoord in te voeren.
referenties worden opgeslagen in een PSCredentialobject en het wachtwoord wordt opgeslagen als een SecureString.
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 vraagt de service die is opgegeven door de parameter for om te bepalen of de service beschikbaar is nadat de computer opnieuw is opgestart.
Deze parameter is alleen geldig samen met de wacht-en Voorparameters.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
als de Delay parameter niet is opgegeven, gebruikt Restart-Computer een vertraging van vijf seconden.
| Type: | Int16 |
| positie: | Named | standaardwaarde: | geen | Accept pipeline input: | False | accepteer jokertekens: | False |
specificeert het gedrag van PowerShell als het wacht tot de opgegeven service of functie beschikbaar is nadat de computer opnieuw is opgestart. Deze parameter is alleen geldig met de wacht parameter.
de aanvaardbare waarden voor deze parameter zijn:
- standaard: wacht tot PowerShell herstart.
- PowerShell: kan opdrachten uitvoeren in een externe PowerShell-sessie op de computer.
- WMI: Ontvangt een antwoord op een Win32_ComputerSystem query voor de computer.
- WinRM: kan een externe sessie op de computer instellen met behulp van WS-Management.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | WaitForServiceTypes | geaccepteerde waarden: | Wmi, WinRM, PowerShell | positie: | Named | standaardwaarde: | geen |
| pipeline-invoer accepteren: | false |
| jokertekens accepteren: | 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. Wanneer de tijdslimiet is verstreken, keert Restart-Computer terug naar de opdrachtprompt, zelfs als de computers niet opnieuw worden opgestart.
De Timeout parameter is alleen geldig met de wacht parameter. Time-out overschrijft de wacht parameter onbepaalde wachttijd.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | Int32 |
| aliassen: | TimeoutSec | positie: | Named | standaardwaarde: | None |
| pijplijn-invoer accepteren: | False | accepteer jokertekens: | False |
Restart-Computer onderdrukt de PowerShell-prompt en blokkeert de pijplijn totdat de computers zijn gestart. U kunt deze parameter in een script gebruiken om computers opnieuw op te starten en vervolgens verder te verwerken wanneer de HERSTART is voltooid.
De parameter Wait wacht voor onbepaalde tijd tot de computers opnieuw worden opgestart. U kunt Timeout gebruiken om de timing en de voor-en Vertragingsparameters aan te passen om te wachten tot bepaalde services beschikbaar zijn op de herstartcomputers.
De Wachtparameter is niet geldig wanneer u de lokale computer opnieuw opstart. Als de waarde van de parameter computernaam de namen van externe computers en de lokale computer bevat, genereertRestart-Computer een niet-afsluitende fout Voor het wachten op de lokale computer, maar wacht tot de externe computers opnieuw worden opgestart.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | 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 | Default value: | False | accept pipeline input: | False | accept jokertekens: | False |
specificeert het mechanisme dat wordt gebruikt om de gebruikersreferenties te verifiëren. Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
de aanvaardbare waarden voor deze parameter zijn: Basic, CredSSP, Default, Digest,Kerberos en Negotiate.
voor meer informatie, zie aanmeldingsmechanisme.
waarschuwing
CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer om te worden geverifieerd, is ontworpen voor opdrachten die authenticatie vereisen op meer dan één bron, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het veiligheidsrisico van de bediening op afstand. Als de externe computer wordt aangetast, kunnen de gegevens die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.
| Type: | String |
| geaccepteerde waarden: | 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.
Notes
- In Windows gebruikt
Restart-Computerde Win32Shutdown-methode van de Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Deze methode vereist dat het seshutdownprivilege privilege ingeschakeld is voor het gebruikersaccount dat gebruikt wordt om de machine te herstarten. - op Linux en Mac OS gebruikt
Restart-ComputerHet/sbin/shutdownbash Gereedschap.
- Over Extern beheer van Windows
- Get-Credential
- WS-Management Protocol