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

Restart-Computer

Modul:
Microsoft.PowerShell.Management Module

Újraindítja az operációs rendszert helyi és távoli számítógépeken.

Syntax

DefaultSet (Alapértelmezett) 

Restart-Computer
    [[-ComputerName] <String[]>]
    [-WsmanAuthentication <String>]
    [-Credential]<PSCredential>]
    [-Force]
    [-Wait]
    [-Timeout <Int32>]
    [-For <WaitForServiceTypes>]
    [-Delay <Int16>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

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.

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.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Kína, __KISZOLGÁLÓ, Szerver, IP cím

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a Restart-Computerfuttatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:Current user
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:Int16
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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épre vonatkozó 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.

Paramétertulajdonságok

Típus:WaitForServiceTypes
Alapértelmezett érték:None
Elfogadott értékek:Wmi, WinRM, PowerShell
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Kényszeríti a számítógép azonnali újraindítását.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:f

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:TimeoutSec

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a Restart-Computer futna. A Restart-Computer parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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.
  • Linux és Mac OPERÁCIÓS rendszeren Restart-Computer a /sbin/shutdown bash eszközt használja.