Megosztás a következőn keresztül:


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 $Namesváltozóban vannak tárolva. Get-Credential felhasználónevet és jelszót kér, és az értékeket a $Credsvá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-Computerfuttatá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

String

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.