Starter operativsystemet på lokale og eksterne datamaskiner.
- Syntaks
- Beskrivelse
- Eksempler
- Eksempel 1: Start den lokale datamaskinen på nytt
- Eksempel 2: Start flere datamaskiner på nytt
- Eksempel 3: Hent datamaskinnavn fra en tekstfil
- Eksempel 4: Tvinge datamaskiner som er oppført i en tekstfil
- Eksempel 6: Start en ekstern datamaskin på nytt og vent Til PowerShell
- Eksempel 7: Start en datamaskin på Nytt ved Hjelp Av WsmanAuthentication
- Parametere
- Inputs
- Outputs
- Merknader
Syntaks
Beskrivelse
Restart-Computer cmdleten starter operativsystemet på lokale og eksterne datamaskiner.
du kan bruke parameterne for Restart-Computer til å kjøre omstartsoperasjonene, til å angi autentiseringsnivåer og alternative legitimasjonsbeskrivelser, til å begrense operasjonene som kjører samtidig,og til å tvinge en umiddelbar omstart.
Starter I Windows PowerShell 3.0, kan du vente på omstart for å fullføre før du kjører nextcommand. Angi et ventetidsavbrudd og spørringsintervall, og vent på at bestemte tjenester skal være tilgjengelige på den omstarte datamaskinen. Denne funksjonen gjør det praktisk å brukeRestart-Computer inscripts og funksjoner.
Eksempler
Eksempel 1: Start den lokale datamaskinen på nytt
Restart-Computer starter den lokale datamaskinen på nytt.
Restart-ComputerEksempel 2: Start flere datamaskiner på nytt
Restart-Computer kan starte eksterne og lokale datamaskiner på nytt. Parameteren Datamaskinnavn godtar anarray av datamaskinnavn.
Restart-Computer -ComputerName Server01, Server02, localhostRestart-Computer henter en liste over datamaskinnavn fra en tekstfil og starter datamaskinene på nytt. Parameteren computername er ikke angitt. Men fordi det er den første posisjonsparameteren, er denaksepterer datamaskinnavnene fra tekstfilen som sendes ned i rørledningen.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content bruker path-parameteren til å hente en liste over datamaskinnavn fra En tekstfil,Domain01.txt. Datamaskinnavnene sendes ned i rørledningen. Restart-Computer starter hver datamaskin på nytt.
Eksempel 4: Tvinge datamaskiner som er oppført i en tekstfil
dette eksemplet tvinger en umiddelbar omstart av datamaskinene som er oppført iDomain01.txt fil. Dendatanavn fra tekstfilen lagres i en variabel. Force-parameteren tvinger animmediate omstart.
Get-Content bruker path-parameteren til å hente en liste over datamaskinnavn fra En tekstfil,Domain01.txt. Datamaskinnavnene lagres i variabelen $NamesGet-Credential spør deg om brukernavn og passord og lagrer verdiene i variabelen $CredsRestart-Computer bruker Datamaskinnavn og Legitimasjonsparametere med variablene. Forceparameter forårsaker en umiddelbar omstart av hver datamaskin.
Eksempel 6: Start en ekstern datamaskin på nytt og vent Til PowerShell
Restart-Computer starter den eksterne datamaskinen på nytt og venter deretter i opptil 5 minutter (300 sekunder) for at powershell skal bli tilgjengelig på den startede datamaskinen før den fortsetter.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer bruker Parameteren Datamaskinnavn til å angi Server01. Waitparameter venter på omstart for å fullføre. For angir At PowerShell kan kjøre kommandoer påden eksterne datamaskinen. Timeout-parameteren angir en ventetid på fem minutter. Delay-parameterenspørrer den eksterne datamaskinen hvert annet sekund for å avgjøre om den startes på nytt.
Eksempel 7: Start en datamaskin på Nytt ved Hjelp Av WsmanAuthentication
Restart-Computer starter den eksterne datamaskinen på Nytt ved Hjelp Av wsmanauthentication-mekanismen.Kerberos-godkjenning bestemmer om gjeldende bruker har tillatelse til å starte remotecomputer på nytt. Hvis du vil ha mer informasjon, seauthenticationmechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer bruker Datamaskinnavn-parameteren til å angi den eksterne datamaskinen, Server01.Parameteren WsmanAuthentication angir godkjenningsmetoden Som Kerberos.
Parametere
Angir ett datamaskinnavn eller en kommadelt matrise med datamaskinnavn. Restart-Computer acceptsComputerName objekter fra rørledningen eller variablene.
Skriv Inn NetBIOS-navnet, EN IP-adresse eller et fullt kvalifisert domenenavn for en ekstern datamaskin. For å angi den lokale datamaskinen, skriv inn datamaskinnavnet, en prikk . eller localhost.
denne parameteren er ikke avhengig Av PowerShell remoting. Du kan bruke Parameteren Datamaskinnavn selvhvis datamaskinen ikke er konfigurert til å kjøre eksterne kommandoer.
Hvis Parameteren Datamaskinnavn ikke er angitt,Restart-Computer starter den lokale datamaskinen på nytt.
| Type: | Streng | Aliaser: | CN, __SERVER, Server, Ip-Adresse | Posisjon: | 0 |
| standardverdi: | 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 |
Angir en brukerkonto som har tillatelse til å utføre denne handlingen. Standard er gjeldende bruker.
Skriv inn et brukernavn, For Eksempel User01 Eller Domain01 \ User01,eller skriv inn Et PSCredential-objekt generert av cmdletenGet-Credential. Hvis du skriver inn et brukernavn, blir du bedt om å skrive innpassord.
Legitimasjon lagres i En PSCredentialobject og passordet er lagret 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 spør tjenesten som er angitt av parameteren for å finne ut om tjenesten er tilgjengelig etter at datamaskinen er startet på nytt.
denne parameteren er bare gyldig sammen Med Ventetiden og for parametere.
denne parameteren ble introdusert I Windows PowerShell 3.0.
hvis Forsinkelsesparameteren ikke er angitt, brukerRestart-Computer en fem sekunders forsinkelse.
| Type: | Int16 |
| Posisjon: | Navngitt | Standardverdi: | Ingen |
| Godta rørinngang: | |
| Godta jokertegn: | False |
Angir virkemåten Til PowerShell mens Den venter på at den angitte tjenesten eller funksjonen skal bli tilgjengelig etter at datamaskinen starter på nytt. Denne parameteren er bare gyldig Med Wait-parameteren.
de akseptable verdiene for denne parameteren er:
- Standard: Venter På At PowerShell skal starte på nytt.
- PowerShell: kan kjøre kommandoer i En PowerShell ekstern økt på datamaskinen.
- WMI: Mottar et svar På En win32_computersystem-spørring for datamaskinen.WinRM: kan opprette en ekstern økt til datamaskinen ved HJELP AV Ws-Management.
denne parameteren ble introdusert I Windows PowerShell 3.0.
| Type: | WaitForServiceTypes | Aksepterte verdier: | Wmi, WinRM, PowerShell |
| Posisjon: | Navngitt |
| standardverdi: | ingen |
| godta jokertegn: | 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 tidsavbruddet utløper, returnerer Restart-Computer til ledeteksten, selv om datamaskinene ikke startes på nytt.
timeout-parameteren er bare gyldig Med Wait-parameteren. Timeout overstyrer thewait parameter ubestemt ventetid.
denne parameteren ble introdusert I Windows PowerShell 3.0.
| Type: | Int32 |
| Aliaser: | TimeoutSec |
| Posisjon: | Navngitt |
| Standardverdi: | ingen |
| godta rørinngang: | |
| Godta jokertegn: | False |
Restart-Computer undertrykker PowerShell-ledeteksten og blokkerer rørledning til datamaskinene harstartet. Du kan bruke denne parameteren i et skript for å starte datamaskiner på nytt og deretter fortsette å behandle når omstart er fullført.
Vent-parameteren venter på ubestemt tid for at datamaskinene skal starte på nytt. Du kan bruke Timeout toadjust timing og For Og Delay parametere for å vente på bestemte tjenester for å bli tilgjengelig på de omstarte datamaskinene.
Vent-parameteren er ikke gyldig når du starter den lokale datamaskinen på nytt. Hvis verdien av parameteren computername inneholder navnene på eksterne datamaskiner og den lokale datamaskinen,Restart-Computer genererer En ikke-avsluttende Feil For Vent På den lokale datamaskinen, men venterfor de eksterne datamaskinene å starte på nytt.
denne parameteren ble introdusert I 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: | Navngitt | Standardverdi: | |
| Godta pipeline-inngang: | |||
| Godta jokertegn: | Falsk |
angir Mekanismen som brukes til å godkjenne brukerlegitimasjonen. Denne parameteren varintrodusert I Windows PowerShell 3.0.
de akseptable verdiene for denne parameteren er: Basic, CredSSP, Default,Digest, Kerberos og Negotiate.
for mer informasjon, seauthenticationmechanism.
Advarsel
godkjenning Av Credential Security Service Provider (CredSSP), der brukerlegitimasjonen sendes til en ekstern datamaskin som skal godkjennes, er utformet for kommandoer som krever autentisering på mer enn en ressurs, for eksempel tilgang til en ekstern nettverksressurs. Denne mekanismenøker sikkerhetsrisikoen ved fjernbetjening. Hvis den eksterne datamaskinen er kompromittert, vilkredentialer som sendes til den, kan brukes til å styre nettverksøkten.
| Type: | Streng |
| Aksepterte verdier: | 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.
Merknader
- i Windows bruker
Restart-Computerwin32shutdown-metoden For Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Denne metoden krever At SeShutdownPrivilege-privilegiet er aktivert for brukerkontoen som brukes til å starte maskinen på nytt. - på Linux og Mac OS bruker
Restart-Computer/sbin/shutdownbash-verktøyet.
- Om Windows Ekstern Administrasjon
- Få-Legitimasjon
- WS-Management Protocol