repornește sistemul de operare pe computerele locale și la distanță.
- sintaxă
- descriere
- Exemple
- Exemplul 1: Reporniți computerul local
- Exemplul 2: Reporniți mai multe computere
- Exemplul 3: Obțineți nume de computer dintr-un fișier text
- Exemplul 4: forțați repornirea computerelor listate într-un fișier text
- exemplul 6: Reporniți un computer la distanță și așteptați ca PowerShell
- exemplul 7: reporniți un computer utilizând wsmanauthentication
- parametri
- Inputs
- Outputs
- Note
sintaxă
descriere
Restart-Computer cmdletul repornește sistemul de operare pe computerele locale și la distanță.
puteți utiliza parametriiRestart-Computer pentru a rula operațiile de repornire, pentru a specifica nivelurile de autentificare și acreditările alternative, pentru a limita operațiile care se execută în același timp și pentru a forța o repornire imediată.
începând cu Windows PowerShell 3.0, puteți aștepta finalizarea repornirii înainte de a rula nextcommand. Specificați un interval de timp de așteptare și de interogare și așteptați ca anumite servicii să fie disponibile pe computerul repornit. Această caracteristică face practic de a utilizaRestart-Computer inscripts și funcții.
Exemple
Exemplul 1: Reporniți computerul local
Restart-Computer repornește computerul local.
Restart-ComputerExemplul 2: Reporniți mai multe computere
Restart-Computer poate reporni computerele de la distanță și locale. Parametrul ComputerName acceptă anarray de nume de computere.
Restart-Computer -ComputerName Server01, Server02, localhostExemplul 3: Obțineți nume de computer dintr-un fișier text
Restart-Computer primește o listă de nume de computer dintr-un fișier text și repornește computerele. Parametrul thecomputorname nu este specificat. Dar pentru că este primul parametru de poziție, acestaacceptă numele computerului din fișierul text care sunt trimise pe conductă.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content utilizează parametrul Path pentru a obține o listă de nume de computer dintr-un fișier text,Domain01.txt. Numele computerului sunt trimise pe conductă. Restart-Computer repornește fiecarecomputer.
Exemplul 4: forțați repornirea computerelor listate într-un fișier text
acest exemplu forțează o repornire imediată a computerelor listate în fișierulDomain01.txt. Numele computerului din fișierul text sunt stocate într-o variabilă. Parametrul Force forțează repornirea animmediate.
Get-Content utilizează parametrul Path pentru a obține o listă de nume de computer dintr-un fișier text,Domain01.txt. Numele computerului sunt stocate în variabila $NamesGet-Credential vă solicită un nume de utilizator și o parolă și stochează valorile din variabila $CredsRestart-Computerutilizează parametrii ComputerName și Credential cu variabilele lor. Forceparameter provoacă o repornire imediată a fiecărui computer.
exemplul 6: Reporniți un computer la distanță și așteptați ca PowerShell
Restart-Computer să repornească computerul la distanță și apoi să aștepte până la 5 minute (300 secunde) pentru ca PowerShell să devină disponibil pe computerul repornit înainte de a continua.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer utilizează parametrul ComputerName pentru a specifica Server01. Waitparameter așteaptă ca repornirea să se termine. For specifică faptul că PowerShell poate rula comenzi pecomputerul la distanță. Parametrul Timeout specifică o așteptare de cinci minute. Parametrul Delayqueries computerul la distanță la fiecare două secunde pentru a determina dacă este repornit.
exemplul 7: reporniți un computer utilizând wsmanauthentication
Restart-Computer repornește computerul la distanță utilizând mecanismul WsmanAuthentication.Autentificarea Kerberos determină dacă utilizatorul curent are permisiunea de a reporni remotecomputer. Pentru mai multe informații, a se vedeaautentificaremecanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer utilizează parametrul ComputerName pentru a specifica computerul la distanță, Server01.Parametrul WsmanAuthentication specifică metoda de autentificare ca Kerberos.
parametri
specifică un nume de computer sau o matrice separată prin virgulă de nume de computer. Restart-Computer acceptăcomputername obiecte din conducta sau variabile.
tastați numele NetBIOS, o adresă IP sau un nume de domeniu complet calificat al unui computer la distanță. Pentru a specifica computerul local, tastați numele computerului, un punct . sau localhost.
acest parametru nu se bazează pe PowerShell remoting. Puteți utiliza parametrul ComputerName evendacă computerul dvs. nu este configurat să ruleze comenzi la distanță.
Dacă parametrul ComputerName nu este specificat,Restart-Computer repornește computerul local.
| Tip: | String |
| pseudonime: | CN, __SERVER, Server, adresă IP |
| poziție: | 0 |
| valoarea implicită: | 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 |
specifică un cont de utilizator care are permisiunea de a face această acțiune. Implicit este utilizatorul curent.
tastați un nume de utilizator, cum ar fi User01 sau Domain01\User01, sau introduceți un obiect Pscredențial generat deGet-Credential cmdlet. Dacă introduceți un nume de utilizator, vi se solicită să introducețiparola.
acreditările sunt stocate într-un PSCredentialobject și parola este stocată ca 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 interoghează serviciul specificat deparametrul for Pentru a determina dacă serviciul este disponibil după repornirea computerului.
acest parametru este valabil numai împreună cu parametrii Wait and For.
acest parametru a fost introdus în Windows PowerShell 3.0.
dacă parametrul întârziere nu este specificat,Restart-Computer utilizează o întârziere de cinci secunde.
| Tip: | Int16 |
| poziție: | numit |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | False |
| Accept caractere wildcard: | False |
specifică comportamentul PowerShell în timp ce așteaptă ca serviciul sau caracteristica specificată să devină disponibilă după repornirea computerului. Acest parametru este valabil numai cu parametrul Wait.
valorile acceptabile pentru acest parametru sunt:
- Default: așteaptă repornirea PowerShell.
- PowerShell: poate rula comenzi într-o sesiune de la distanță PowerShell pe computer.
- WMI: Primește un răspuns la o interogare Win32_ComputerSystem pentru computer.
- WinRM: poate stabili o sesiune la distanță la computer utilizând WS-Management.
acest parametru a fost introdus în Windows PowerShell 3.0.
| Tip: | WaitForServiceTypes |
| valori acceptate: | Wmi, WinRM, PowerShell |
| poziție: | numit |
| valoare implicită: | nici unul |
| accepta intrare conducte: | false |
| accepta caractere wildcard: | 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. Când expirarea timpului de expirare,Restart-Computer revine la promptul de comandă, chiar dacă computerele nu sunt repornite.
parametrul Timeout este valabil numai cu parametrul Wait. Timeout suprascrie perioada de așteptare nedeterminată thewait parametrului.
acest parametru a fost introdus în Windows PowerShell 3.0.
| Tip: | Int32 |
| pseudonime: | TimeoutSec |
| poziție: | numit |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | False |
| accepta caractere wildcard: | False |
Restart-Computer suprimă promptul PowerShell și blocuri conducta până când computerele aua început. Puteți utiliza acest parametru într-un script pentru a reporni computerele și apoi continuați să procesațiatunci când repornirea este terminată.
parametrul așteptare așteaptă la nesfârșit repornirea computerelor. Puteți utiliza Timeout pentru a regla sincronizarea și parametrii For și Delay pentru a aștepta ca anumite servicii să devină disponibile pe computerele repornite.
parametrul așteptare nu este valid când reporniți computerul local. Dacă valoarea parametrului theComputerName conține numele computerelor la distanță și al computerului local,Restart-Computer generează o eroare non-terminare pentru Așteptați pe computerul local, dar așteptațipentru repornirea computerelor la distanță.
acest parametru a fost introdus în Windows PowerShell 3.0.
| Tip: | 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: | numit |
| valoare implicită: | False | accepta intrare conducte: | False |
| accepta caractere wildcard: | False |
specifică mecanismul care este utilizat pentru autentificarea acreditărilor utilizatorului. Acest parametru a fostintrodus în Windows PowerShell 3.0.
valorile acceptabile pentru acest parametru sunt: Basic, CredSSP, Default, Digest,Kerberos și negocia.
pentru mai multe informații, consultați mecanismul de autentificare.
avertizare
autentificarea furnizorului de servicii de securitate a acreditărilor (CredSSP), în care acreditările utilizatorului sunt transferate pe un computer la distanță pentru a fi autentificate, este proiectată pentru comenzi care necesită autentificarea pe mai multe resurse, cum ar fi accesarea unei partajări de rețea la distanță. Acest mecanismcrește riscul de securitate al operației la distanță. Dacă computerul la distanță este compromis, acredențialele care îi sunt transmise pot fi utilizate pentru a controla sesiunea de rețea.
| Tip: | String |
| valori acceptate: | 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.
Note
- În Windows,
Restart-Computerutilizează metoda Win32Shutdown a Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Această metodă necesită ca privilegiul SeShutdownPrivilege să fie activat pentru contul de utilizator utilizat pentru a reporni aparatul. - pe Linux și Mac OS,
Restart-Computerutilizează/sbin/shutdowninstrument bash.
- despre Windows Remote Management
- Get-acreditare
- WS-Management Protocol