Restart-Computer
Start het besturingssysteem opnieuw op lokale en externe computers.
Syntax
Restart-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential]<PSCredential>]
[-Force]
[-Wait]
[-Timeout <Int32>]
[-For <WaitForServiceTypes>]
[-Delay <Int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Deze cmdlet is alleen beschikbaar op het Windows-platform.
De Restart-Computer
cmdlet start het besturingssysteem opnieuw op de lokale en externe computers.
U kunt de parameters van Restart-Computer
gebruiken om de herstartbewerkingen uit te voeren, om de verificatieniveaus en alternatieve referenties op te geven, om de bewerkingen die op hetzelfde moment worden uitgevoerd te beperken en om onmiddellijk opnieuw opstarten af te dwingen.
Vanaf Windows PowerShell 3.0 kunt u wachten totdat het opnieuw opstarten is voltooid voordat u de volgende opdracht uitvoert. Geef een wachttijd en queryinterval op en wacht tot bepaalde services beschikbaar zijn op de opnieuw opgestarte computer. Deze functie maakt het handig om te gebruiken Restart-Computer
in scripts en functies.
Voorbeelden
Voorbeeld 1: De lokale computer opnieuw opstarten
Restart-Computer
start de lokale computer opnieuw op.
Restart-Computer
Voorbeeld 2: Meerdere computers opnieuw opstarten
Restart-Computer
kan externe en lokale computers opnieuw opstarten. De parameter ComputerName accepteert een matrix met computernamen.
Restart-Computer -ComputerName Server01, Server02, localhost
Voorbeeld 3: Computernamen ophalen uit een tekstbestand
Restart-Computer
haalt een lijst met computernamen op uit een tekstbestand en start de computers opnieuw op. De parameter ComputerName is niet opgegeven. Maar omdat dit de eerste positieparameter is, accepteert deze de computernamen uit het tekstbestand die door de pijplijn worden verzonden.
Get-Content -Path C:\Domain01.txt | Restart-Computer
Get-Content
gebruikt de parameter Path om een lijst met computernamen op te halen uit een tekstbestand ,Domain01.txt. De computernamen worden door de pijplijn verzonden. Restart-Computer
start elke computer opnieuw op.
Voorbeeld 4: Geforceerd opnieuw opstarten van computers die worden vermeld in een tekstbestand
In dit voorbeeld wordt een onmiddellijke herstart afgedwongen van de computers die in het Domain01.txt
bestand worden vermeld. De computernamen uit het tekstbestand worden opgeslagen in een variabele. De parameter Force dwingt een onmiddellijke herstart af.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force
Get-Content
gebruikt de parameter Path om een lijst met computernamen op te halen uit een tekstbestand ,Domain01.txt. De computernamen worden opgeslagen in de variabele $Names
. Get-Credential
vraagt u om een gebruikersnaam en wachtwoord en slaat de waarden op in de variabele $Creds
. Restart-Computer
gebruikt de parameters ComputerName en Credential met hun variabelen. De parameter Force zorgt ervoor dat elke computer onmiddellijk opnieuw wordt opgestart.
Voorbeeld 6: Een externe computer opnieuw opstarten en wachten op PowerShell
Restart-Computer
start de externe computer opnieuw op en wacht vervolgens maximaal 5 minuten (300 seconden) tot PowerShell beschikbaar is op de opnieuw opgestarte computer voordat deze wordt voortgezet.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2
Restart-Computer
gebruikt de parameter ComputerName om Server01 op te geven. De parameter Wait wacht totdat het opnieuw opstarten is voltooid. De Voor geeft aan dat PowerShell opdrachten kan uitvoeren op de externe computer. Met de time-outparameter wordt een wachttijd van vijf minuten opgegeven. De parameter Delay voert elke twee seconden een query uit op de externe computer om te bepalen of deze opnieuw wordt opgestart.
Voorbeeld 7: Een computer opnieuw opstarten met WsmanAuthentication
Restart-Computer
start de externe computer opnieuw op met behulp van het WsmanAuthentication-mechanisme .
Kerberos-verificatie bepaalt of de huidige gebruiker gemachtigd is om de externe computer opnieuw op te starten. Zie AuthenticationMechanism voor meer informatie.
Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos
Restart-Computer
gebruikt de parameter ComputerName om de externe computer Server01 op te geven.
De WsmanAuthentication parameter specificeert de verificatiemethode als Kerberos.
Parameters
-ComputerName
Hiermee geeft u één computernaam of een door komma's gescheiden matrix met computernamen op. Restart-Computer
accepteert ComputerName-objecten uit de pijplijn of variabelen.
Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een externe computer. Als u de lokale computer wilt opgeven, typt u de computernaam, een punt .
of localhost.
Deze parameter is niet afhankelijk van externe communicatie van PowerShell. U kunt de parameter ComputerName zelfs gebruiken als uw computer niet is geconfigureerd om externe opdrachten uit te voeren.
Als de parameter ComputerName niet is opgegeven, Restart-Computer
start de lokale computer opnieuw op.
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vraagt u om bevestiging voordat u uitvoert Restart-Computer
.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Standaard is dit de huidige gebruiker.
Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat is gegenereerd door de Get-Credential
cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.
Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString.
Notitie
Zie Hoe veilig is SecureString? voor meer informatie over SecureString-gegevensbeveiliging.
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Delay
Hiermee geeft u de frequentie van query's, in seconden. PowerShell voert een query uit op de service die is opgegeven met 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 parameters Wachten en Voor .
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Als de parameter Delay niet is opgegeven, Restart-Computer
wordt een vertraging van vijf seconden gebruikt.
Type: | Int16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-For
Hiermee geeft u het gedrag van PowerShell op wanneer wordt gewacht tot de opgegeven service of functie beschikbaar is nadat de computer opnieuw is opgestart. Deze parameter is alleen geldig met de parameter Wait .
De aanvaardbare waarden voor deze parameter zijn:
- Standaardinstelling: Wacht tot PowerShell opnieuw wordt opgestart.
- 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 met de computer tot stand brengen met behulp van WS-Management.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Type: | WaitForServiceTypes |
Accepted values: | Wmi, WinRM, PowerShell |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Hiermee wordt een onmiddellijke herstart van de computer afgedwongen.
Type: | SwitchParameter |
Aliases: | f |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Hiermee geeft u de duur van de wachttijd, in seconden. Wanneer de time-out is verstreken, Restart-Computer
keert u terug naar de opdrachtprompt, zelfs als de computers niet opnieuw worden opgestart.
De time-outparameter is alleen geldig met de parameter Wait . Time-out overschrijft de onbeperkte wachttijd van de parameter Wait .
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Type: | Int32 |
Aliases: | TimeoutSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wait
Restart-Computer
onderdrukt de PowerShell-prompt en blokkeert de pijplijn totdat de computers opnieuw zijn opgestart. U kunt deze parameter in een script gebruiken om computers opnieuw op te starten en vervolgens door te gaan met verwerken wanneer het opnieuw opstarten is voltooid.
De parameter Wait wacht voor onbepaalde tijd totdat de computers opnieuw zijn opgestart. U kunt Time-out gebruiken om de tijdsinstellingen en de parameters Voor en Vertraging aan te passen om te wachten tot bepaalde services beschikbaar zijn op de opnieuw opgestarte computers.
De parameter Wait is niet geldig wanneer u de lokale computer opnieuw opstart. Als de waarde van de parameter ComputerName de namen van externe computers en de lokale computer bevat, Restart-Computer
genereert een niet-afsluitfout voor Wachten op de lokale computer, maar wacht totdat de externe computers opnieuw worden opgestart.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hier ziet u wat er gebeurt als de Restart-Computer
uitvoeringen worden uitgevoerd. De Restart-Computer
cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
Hiermee geeft u het mechanisme op dat wordt gebruikt om de gebruikersreferenties te verifiëren. Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
De acceptabele waarden voor deze parameter zijn: Basic, CredSSP, Default, Digest, Kerberos en Negotiate.
Zie AuthenticationMechanism voor meer informatie.
Waarschuwing
CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer om te worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is gecompromitteerd, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.
Type: | String |
Accepted values: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
Restart-Computer
accepteert computernamen uit de pijplijn of variabelen.
Uitvoerwaarden
None
Restart-Computer
genereert geen uitvoer.
Notities
- In Windows
Restart-Computer
gebruikt u de methode Win32Shutdown van de WMI-klasse (Windows Management Instrumentation) Win32_OperatingSystem. Voor deze methode moet de bevoegdheid SeShutdownPrivilege zijn ingeschakeld voor het gebruikersaccount dat wordt gebruikt om de computer opnieuw op te starten. - In Linux en Mac OS
Restart-Computer
wordt het/sbin/shutdown
hulpprogramma bash gebruikt.