Restart-Computer
Újraindítja az operációs rendszert helyi és távoli számítógépeken.
Syntax
Restart-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential]<PSCredential>]
[-Force]
[-Wait]
[-Timeout <Int32>]
[-For <WaitForServiceTypes>]
[-Delay <Int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Restart-Computer
parancsmag újraindítja az operációs rendszert a helyi és távoli számítógépeken.
A Restart-Computer
paramétereivel futtathatja az újraindítási műveleteket, megadhatja a hitelesítési szinteket és a másodlagos hitelesítő adatokat, korlátozhatja az egyidejűleg futó műveleteket, és azonnali újraindítást kényszeríthet ki.
A Windows PowerShell 3.0-tól a következő parancs futtatása előtt megvárhatja az újraindítás befejezését. Adjon meg egy várakozási időtúllépési és lekérdezési időközt, és várja meg, amíg bizonyos szolgáltatások elérhetők lesznek az újraindított számítógépen. Ez a funkció praktikussá teszi a Restart-Computer
szkriptekben és függvényekben való használatát.
A PowerShell 7.1-ben Restart-Computer
lett hozzáadva Linuxhoz és macOS-hez. A nem Windows-platformok csak a WhatIf, Confirm és CommonParameters paraméterekkel rendelkeznek. A parancsmag csak meghívja a natív parancsot /sbin/shutdown
.
Példák
1. példa: A helyi számítógép újraindítása
Restart-Computer
újraindítja a helyi számítógépet.
Restart-Computer
2. példa: Több számítógép újraindítása
Restart-Computer
újraindíthatja a távoli és a helyi számítógépeket. A ComputerName paraméter számítógépnevek tömböt fogad el.
Restart-Computer -ComputerName Server01, Server02, localhost
3. példa: Számítógépnevek lekérése szövegfájlból
Restart-Computer
lekéri a számítógépnevek listáját egy szövegfájlból, és újraindítja a számítógépeket. A ComputerName paraméter nincs megadva. Mivel azonban ez az első pozícióparaméter, elfogadja a számítógépneveket a folyamaton keresztül küldött szövegfájlból.
Get-Content -Path C:\Domain01.txt | Restart-Computer
Get-Content
a Path paraméter segítségével kinyeri a számítógépnevek listáját egy szövegfájlból, Domain01.txt. A számítógépneveket elküldik a csatornán keresztül.
Restart-Computer
újraindítja az egyes számítógépeket.
4. példa: A szövegfájlban felsorolt számítógépek újraindításának kényszerítése
Ez a példa a Domain01.txt
fájlban felsorolt számítógépek azonnali újraindítását kényszeríti ki. A szövegfájl számítógépneveit egy változó tárolja. A Force paraméter azonnali újraindítást kényszerít ki.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force
Get-Content
a Path paraméter segítségével kinyeri a számítógépnevek listáját egy szövegfájlból, Domain01.txt. A számítógépnevek a $Names
változóban vannak tárolva.
Get-Credential
felhasználónevet és jelszót kér, és az értékeket a $Creds
változóban tárolja.
Restart-Computer
a ComputerName és Hitelesítő adatok paramétereket használja a változókkal együtt. A Force paraméter az egyes számítógépek azonnali újraindítását okozza.
6. példa: Távoli számítógép újraindítása és a PowerShell várakozása
Restart-Computer
újraindítja a távoli számítógépet, majd akár 5 percet (300 másodpercet) vár, amíg a PowerShell elérhetővé válik az újraindított számítógépen a folytatás előtt.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2
Restart-Computer
a ComputerName paramétert használja Server01megadásához. A Wait paraméter megvárja az újraindítás befejezését. A azt határozza meg, hogy a PowerShell parancsokat futtathat a távoli számítógépen. Az időkorlát paraméter ötperces várakozást határoz meg. A Delay paraméter két másodpercenként lekérdezi a távoli számítógépet annak megállapításához, hogy újraindult-e.
7. példa: Számítógép újraindítása a WsmanAuthentication használatával
Restart-Computer
a WsmanAuthentication mechanizmussal újraindítja a távoli számítógépet.
A Kerberos-hitelesítés határozza meg, hogy az aktuális felhasználó jogosult-e a távoli számítógép újraindítására. További információkért lásd: AuthenticationMechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos
Restart-Computer
a ComputerName paraméterrel adja meg a távoli számítógépet, Server01.
A WsmanAuthentication paraméter a hitelesítési módszert Kerberosnéven adja meg.
Paraméterek
-ComputerName
Egy számítógépnevet vagy számítógépnevek vesszővel tagolt tömbét adja meg.
Restart-Computer
fogadja ComputerName objektumokat a folyamatból vagy változókból.
Írja be egy távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét, egy pontot (.
) vagy a localhostot.
Ez a paraméter nem támaszkodik a PowerShell távoli elérésre. A ComputerName paramétert akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Ha a ComputerName paraméter nincs megadva, Restart-Computer
újraindítja a helyi számítógépet.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | String[] |
Aliasok: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Megerősítést kér a Restart-Computer
futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential
parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.
Jegyzet
További információ a SecureString adatvédelemmel kapcsolatban: lásd Mennyire biztonságos a SecureString?.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | PSCredential |
Position: | 1 |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Delay
A lekérdezések gyakoriságát adja meg másodpercben. A PowerShell lekérdezi a For paraméter által megadott szolgáltatást annak megállapításához, hogy a szolgáltatás elérhető-e a számítógép újraindítása után.
Ez a paraméter csak a Várakozás és a For paraméterekkel együtt érvényes.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Ha a Delay paraméter nincs megadva, Restart-Computer
öt másodperces késleltetést használ.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | Int16 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-For
Meghatározza a PowerShell viselkedését, amikor a megadott szolgáltatás vagy funkció elérhetővé válik a számítógép újraindítása után. Ez a paraméter csak a Wait paraméterrel érvényes.
A paraméter elfogadható értékei a következők:
- Alapértelmezett: Megvárja, amíg a PowerShell újraindul.
- PowerShell-: Parancsokat futtathat egy PowerShell távoli munkamenetben a számítógépen.
- WMI-: Választ kap a számítógép Win32_ComputerSystem lekérdezésére.
- WinRM: A WS-Management használatával távoli munkamenetet hozhat létre a számítógépen.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be. Ez a paraméter csak Windows-platformokon érhető el.
Típus: | WaitForServiceTypes |
Elfogadott értékek: | Wmi, WinRM, PowerShell |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Force
Kényszeríti a számítógép azonnali újraindítását.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | SwitchParameter |
Aliasok: | f |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Timeout
A várakozás időtartamát adja meg másodpercben. Az időtúllépés leteltével Restart-Computer
visszatér a parancssorba, még akkor is, ha a számítógépek nem indulnak újra.
Az időtúllépési paraméter csak a Várakozás paraméterrel érvényes. Időtúllépés felülírja a Várakozás paraméter határozatlan idejű várakozási idejét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | Int32 |
Aliasok: | TimeoutSec |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Wait
Restart-Computer
letiltja a PowerShell-parancssort, és letiltja a folyamatot, amíg a számítógépek újra nem indulnak. Ezt a paramétert parancsfájlban használhatja a számítógépek újraindításához, majd az újraindítás befejezése után is folytathatja a feldolgozást.
A Wait paraméter határozatlan ideig várakozik, amíg a számítógépek újraindulnak. Az időtúllépési használatával módosíthatja az időzítést és a A és késleltetési paraméterek esetében megvárhatja, amíg bizonyos szolgáltatások elérhetővé válnak az újraindított számítógépeken.
A Várakozás paraméter nem érvényes a helyi számítógép újraindításakor. Ha a ComputerName paraméter értéke tartalmazza a távoli és a helyi számítógép neveit, Restart-Computer
nem végleges hibát okoz a várakozás során a helyi számítógépen, de megvárja, amíg a távoli számítógépek újraindulnak.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be. Ez a paraméter csak Windows-platformokon érhető el.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Megjeleníti, mi történne, ha a Restart-Computer
futna. A Restart-Computer
parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WsmanAuthentication
Megadja a felhasználói hitelesítő adatok hitelesítéséhez használt mechanizmust. Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
A paraméter elfogadható értékei a következők: Alapszintű, CredSSP, Alapértelmezett, Kivonatoló, Kerberosés Egyeztetési.
További információkért lásd: AuthenticationMechanism.
Figyelmeztetés
A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.
Ez a paraméter csak Windows-platformokon érhető el.
Típus: | String |
Elfogadott értékek: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Erre a parancsmagra egy számítógép nevét tartalmazó karakterláncot átirányíthat.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
- Windows rendszerben
Restart-Computer
a Windows Management Instrumentation (WMI) Win32_OperatingSystem osztály Win32Shutdown metódust használja. Ehhez a metódushoz engedélyezni kell a SeShutdownPrivilege jogosultságot a gép újraindításához használt felhasználói fiókhoz. - Ez a parancsmag Linuxhoz és macOS-hez lett hozzáadva a PowerShell 7.1-ben. Linux és macOS rendszeren
Restart-Computer
a/sbin/shutdown
bash eszközt használja.