startar om operativsystemet på lokala och fjärrdatorer.
- Syntax
- beskrivning
- exempel
- exempel 1: Starta om den lokala datorn
- exempel 2: Starta om flera datorer
- exempel 3: Hämta datornamn från en textfil
- exempel 4: tvinga omstart av datorer som listas i en textfil
- exempel 6: Starta om en fjärrdator och vänta på PowerShell
- exempel 7: Starta om en dator med wsmanauthentication
- parametrar
- Inputs
- Outputs
- anteckningar
Syntax
beskrivning
Restart-Computer cmdlet startar om operativsystemet på lokala och fjärrdatorer.
Du kan använda parametrarna för Restart-Computer för att köra omstartsoperationerna, för att specifikaautentiseringsnivåer och alternativa referenser, för att begränsa de operationer som körs samtidigt och för att tvinga en omedelbar omstart.
starta i Windows PowerShell 3.0 kan du vänta tills omstarten är klar innan du kör nextcommand. Ange ett väntetid och frågeintervall och vänta på att vissa tjänster ska varatillgänglig på den omstartade datorn. Den här funktionen gör det praktiskt att användaRestart-Computer inscripts och funktioner.
exempel
exempel 1: Starta om den lokala datorn
Restart-Computer startar om den lokala datorn.
Restart-Computerexempel 2: Starta om flera datorer
Restart-Computer kan starta om fjärr-och lokala datorer. Parametern ComputerName accepterar anarray av datornamn.
Restart-Computer -ComputerName Server01, Server02, localhostexempel 3: Hämta datornamn från en textfil
Restart-Computer hämtar en lista med datornamn från en textfil och startar om datorerna. Parametern datornamn anges inte. Men eftersom det är den första positionsparametern, denaccepterar datornamnen från textfilen som skickas ner i rörledningen.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content använder sökvägsparametern för att få en lista över datornamn från en textfil,Domain01.txt. Datornamnen skickas ner i rörledningen. Restart-Computer startar om varjedator.
exempel 4: tvinga omstart av datorer som listas i en textfil
detta exempel tvingar en omedelbar omstart av datorerna som listas i filenDomain01.txt. Dedatornamn från textfilen lagras i en variabel. Kraftparametern tvingar animmediate omstart.
Get-Content använder sökvägsparametern för att få en lista med datornamn från en textfil,Domain01.txt. Datornamnen lagras i variabeln $NamesGet-Credentialuppmanar dig att ange ett användarnamn och lösenord och lagrar värdena i variabeln $CredsRestart-Computer använder Datornamn och referensparametrar med sina variabler. Forceparametern orsakar en omedelbar omstart av varje dator.
exempel 6: Starta om en fjärrdator och vänta på PowerShell
Restart-Computer startar om fjärrdatorn och väntar sedan upp till 5 minuter (300 sekunder) för att PowerShell ska bli tillgängligt på den omstartade datorn innan den fortsätter.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer använder parametern datornamn för att ange Server01. Waitparametern väntar på att omstarten är klar. For anger att PowerShell kan köra kommandon påfjärrdatorn. Timeout-parametern anger en fem minuters väntan. Fördröjningsparametern frågar fjärrdatorn varannan sekund för att avgöra om den startas om.
exempel 7: Starta om en dator med wsmanauthentication
Restart-Computer startar om fjärrdatorn med wsmanauthentication-mekanismen.Kerberos-autentisering avgör om den aktuella användaren har behörighet att starta om fjärrkontrollendator. För mer information, seautentiseringmekanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer använder parametern ComputerName för att ange fjärrdatorn Server01.Parametern wsmanauthentication anger autentiseringsmetoden som Kerberos.
parametrar
anger ett datornamn eller en kommaseparerad matris med datornamn. Restart-Computer acceptsComputerName-objekt från rörledningen eller variablerna.
skriv NetBIOS namn, en IP-adress eller ett fullständigt kvalificerat domännamn på en fjärrdator. Ange den lokala datorn, skriv datornamnet, en punkt . eller localhost.
denna parameter är inte beroende av PowerShell remoting. Du kan använda parametern datornamn även om datorn inte är konfigurerad för att köra fjärrkommandon.
om parametern datornamn inte anges startar Restart-Computer den lokala datorn.
| Typ: | sträng |
| Alias: | CN, __SERVER, Server, IPAddress |
| 0 | |
| standardvärde: | 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 |
anger ett användarkonto som har behörighet att göra denna åtgärd. Standardvärdet är den aktuella användaren.
Skriv ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt genererat av Get-Credential cmdlet. Om du skriver ett användarnamn uppmanas du att angelösenordet.
referenser lagras i ett PSCredentialobject och lösenordet lagras som en 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 frågar den tjänst som anges av theFor-parametern för att avgöra om tjänsten är tillgänglig efter att datorn har startats om.
denna parameter gäller endast tillsammans med vänta och för parametrar.
denna parameter introducerades i Windows PowerShell 3.0.
om Fördröjningsparametern inte anges använderRestart-Computer en fem sekunders fördröjning.
| Typ: | Int16 |
| Position: | namngiven |
| standardvärde: | ingen |
| Acceptera pipelineinmatning: | False |
| Acceptera jokertecken: | False |
anger Powershells beteende eftersom det väntar på att den angivna tjänsten eller funktionen ska blitillgänglig efter att datorn har startats om. Denna parameter är endast giltig med Vänteparametern.
de acceptabla värdena för denna parameter är:
- standard: väntar på att PowerShell startas om.
- PowerShell: kan köra kommandon i en PowerShell – fjärrsession på datorn.
- WMI: Får ett svar på en Win32_ComputerSystem-Fråga för datorn.
- WinRM: kan upprätta en fjärrsession till datorn med hjälp av WS-Management.
denna parameter introducerades i Windows PowerShell 3.0.
| Typ: | WaitForServiceTypes |
| Wmi, WinRM, PowerShell | |
| Position: | namngiven |
| standardvärde: | ingen |
| Acceptera pipelineinmatning: | falskt |
| Acceptera jokertecken: | 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. När timeout förflutit,Restart-Computer returnertill kommandotolken, även om datorerna inte startas om.
timeout-parametern är endast giltig med Wait-parametern. Timeout åsidosätter wait-parameterns obestämda väntetid.
denna parameter introducerades i Windows PowerShell 3.0.
| Typ: | Int32 |
| Alias: | TimeoutSec |
| läge: | namngivna |
| standardvärde: | ingen |
| Acceptera pipelineinmatning: | False |
| Acceptera jokertecken: | False |
Restart-Computer undertrycker PowerShell-prompten och blockerar rörledningen tills datorerna harstartade om. Du kan använda den här parametern i ett skript för att starta om datorer och sedan fortsätta att bearbetanär omstarten är klar.
parametern vänta väntar på obestämd tid för att datorerna ska starta om. Du kan använda Timeout för att justera tidpunkten och för-och Fördröjningsparametrarna för att vänta på att vissa tjänster ska bli tillgängliga på de omstartade datorerna.
parametern vänta är inte giltig när du startar om den lokala datorn. Om värdet på dataparametern innehåller namnen på fjärrdatorer och den lokala datorn,Restart-Computer genererar ett icke-avslutande fel för att vänta på den lokala datorn, men väntar på att fjärrdatorerna ska starta om.
denna parameter introducerades i Windows PowerShell 3.0.
| 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: | namngiven |
| standardvärde: | falskt | Acceptera pipelineinmatning: | falskt | Acceptera jokertecken: | falskt |
anger den mekanism som används för att autentisera användaruppgifterna. Denna parameter varintroducerad i Windows PowerShell 3.0.
de acceptabla värdena för denna parameter är: Basic, CredSSP, Default, Digest,Kerberos och Negotiate.
För mer information, seautenticationmechanism.
Varning
autentisering av Credential Security Service Provider (CredSSP), där användaruppgifterna överförs till en fjärrdator som ska autentiseras, är utformad för kommandon som kräverautentisering på mer än en resurs, till exempel åtkomst till en fjärransluten nätverksresurs. Denna mekanismökar säkerhetsrisken för fjärrkontrollen. Om fjärrdatorn äventyras, denkredentialer som skickas till den kan användas för att styra nätverkssessionen.
| Typ: | sträng |
| accepterade värden: | 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.
anteckningar
- i Windows,
Restart-Computeranvänder Win32Shutdown methodof Windows Management Instrumentation (WMI) Win32_operatingssystemclass. Den här metoden kräver att seshutdownprivilege-privilegiet aktiveras för användarkontot som används för att starta om datorn. - på Linux och Mac OS använder
Restart-Computer/sbin/shutdownbash-verktyget.
- Om Windows fjärrhantering
- Get-Credential
- WS-Management Protocol