Restart-Computer

Start het besturingssysteem opnieuw op lokale en externe computers.

Syntax

DefaultSet (Standaard)

Restart-Computer
    [[-ComputerName] <String[]>]
    [-WsmanAuthentication <String>]
    [-Credential]<PSCredential>]
    [-Force]
    [-Wait]
    [-Timeout <Int32>]
    [-For <WaitForServiceTypes>]
    [-Delay <Int16>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De Restart-Computer cmdlet start het besturingssysteem opnieuw op de lokale en externe computers.

U kunt de parameters voor het uitvoeren van Restart-Computer de herstartbewerkingen gebruiken om de verificatieniveaus en alternatieve referenties op te geven, de bewerkingen te beperken die tegelijkertijd worden uitgevoerd en om een onmiddellijke herstart af te dwingen.

Vanaf Windows PowerShell 3.0 kunt u wachten tot het opnieuw opstarten is voltooid voordat u de volgende opdracht uitvoert. Geef een time-out en queryinterval op en wacht tot bepaalde services beschikbaar zijn op de computer die opnieuw is opgestart. Deze functie maakt het praktisch om te gebruiken Restart-Computer in scripts en functies.

In PowerShell 7.1 is Restart-Computer toegevoegd voor Linux en macOS. De niet-Windows platforms hebben alleen de parameters WhatIf, Confirm en CommonParameters. De cmdlet roept alleen de systeemeigen opdracht /sbin/shutdownaan.

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 het de eerste positieparameter is, accepteert het de computernamen uit het tekstbestand dat door de pijplijn wordt 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 via de pijplijn verzonden. Restart-Computer start elke computer opnieuw op.

Voorbeeld 4: Opnieuw opstarten van computers afdwingen die worden vermeld in een tekstbestand

In dit voorbeeld wordt een onmiddellijke herstart van de computers in het Domain01.txt bestand afgestaan. 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 computernaam - en referentieparameters 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 tot 5 minuten (300 seconden) voordat PowerShell beschikbaar is op de opnieuw opgestarte computer voordat deze doorgaat.

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer gebruikt de parameter ComputerName om Server01 op te geven. De wachtparameter wacht totdat het opnieuw opstarten is voltooid. De for geeft aan dat PowerShell opdrachten kan uitvoeren op de externe computer. De time-outparameter geeft een wachttijd van vijf minuten op. 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 parameter WsmanAuthentication 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 PowerShell-remotegebruik. U kunt de parameter ComputerName gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

Als de parameter ComputerName niet is opgegeven, Restart-Computer start u de lokale computer opnieuw op.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:China, __SERVER, Server, IPAddress

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Vraagt u om bevestiging voordat u Restart-Computeruitvoert.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is 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.

Note

Zie voor meer informatie over SecureString gegevensbeveiliging Hoe veilig is SecureString?.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:PSCredential
Default value:Current user
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Delay

Hiermee geeft u de frequentie van query's, in seconden. PowerShell voert een query uit op 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 in combinatie met de parameters Wachten en Op .

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Als de parameter Delay niet is opgegeven, Restart-Computer gebruikt u een vertraging van vijf seconden.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:Int16
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-For

Hiermee geeft u het gedrag van PowerShell op terwijl 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 acceptabele waarden voor deze parameter zijn:

  • Standaard: wacht tot PowerShell opnieuw is 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 tot stand brengen op de computer met behulp van WS-Management.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0. Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:WaitForServiceTypes
Default value:None
Geaccepteerde waarden:Wmi, WinRM, PowerShell
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Dwingt een onmiddellijke herstart van de computer af.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:f

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:TimeoutSec

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 wanneer het opnieuw opstarten is voltooid.

De wachtparameter wacht voor onbepaalde tijd totdat de computers opnieuw worden 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 wachtparameter 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, genereert u Restart-Computer een niet-afsluitfout voor Wachten op de lokale computer, maar wacht tot de externe computers opnieuw worden opgestart.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0. Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Laat zien wat er zou gebeuren als de Restart-Computer uitvoeringen worden uitgevoerd. De Restart-Computer cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Warning

CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer die moet 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 op afstand uitgevoerde bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

Deze parameter is alleen beschikbaar op Windows platforms.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

U kunt een tekenreeks met een computernaam doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

  • In Windows Restart-Computer gebruikt u de Win32Shutdown-methodeWin32_OperatingSystem klasse. Voor deze methode is vereist dat de bevoegdheid SeShutdownPrivilege is ingeschakeld voor het gebruikersaccount dat wordt gebruikt om de computer opnieuw op te starten.
  • Deze cmdlet is toegevoegd voor Linux en macOS in PowerShell 7.1. In Linux en macOS Restart-Computer wordt het /sbin/shutdown bash-hulpprogramma gebruikt.