Restart-Computer
Újraindítja az operációs rendszert helyi és távoli számítógépeken.
Syntax
DefaultSet (Alapértelmezett)
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-WsmanAuthentication <string>]
[-Protocol <string>]
[-Force]
[-Wait]
[-Timeout <int>]
[-For <WaitForServiceTypes>]
[-Delay <int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsJobSet
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-Force]
[-ThrottleLimit <int>]
[-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.
Az Restart-Computer paramétereivel háttérfeladatként 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 WS-Management (WSMan) protokoll használatával újraindíthatja a számítógépet, ha az elosztott összetevő-objektummodell (DCOM) hívásait blokkolják, például egy vállalati tűzfal. További információ: WS-Management Protokoll.
Ehhez a parancsmaghoz a Windows PowerShell csak akkor szükséges, ha az AsJob paramétert használja egy parancsban.
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épek újraindítása háttérfeladatként
Ezek a parancsok háttérfeladatként futtatnak egy Restart-Computer parancsot két távoli számítógépen, majd lekérik az eredményeket.
Mivel AsJob létrehozza a feladatot a helyi számítógépen, és automatikusan visszaadja az eredményeket a helyi számítógépnek, helyi parancsként futtathatja Receive-Job.
$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job
Restart-Computer a ComputerName paraméterrel adja meg Server01 és Server02. Az AsJob paraméter háttérfeladatként futtatja a parancsot. A feladatobjektum a $Job változóban van tárolva.
$Job a rendszer elküldi a folyamatot az eredményeket lekérő Receive-Job parancsmagnak.
4. példa: Távoli számítógép újraindítása
Restart-Computer egyéni megszemélyesítési és hitelesítési beállításokkal újraindít egy távoli számítógépet.
Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Restart-Computer a ComputerName paramétert használja Server01megadásához. A megszemélyesítési paraméter névtelenül adja meg a kérelmező identitásának elrejtését. A DcomAuthentication paraméter a PacketIntegrity paramétert adja meg a kapcsolat hitelesítési szintjeként.
5. 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, és a ThrottleLimit paraméter korlátozza az egyidejű kapcsolatok számát.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force -ThrottleLimit 10
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. A ThrottleLimit paraméter 10 egyidejű kapcsolatra korlátozza a parancsot.
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 WSMan protokoll használatával
Restart-Computer az alapértelmezett DCOM helyett a WSMan protokoll használatával ú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.
Ezeket a beállításokat olyan vállalatok számára tervezték, amelyeknél a DCOM-alapú újraindítások meghiúsulnak, mert a DCOM le van tiltva. Például tűzfallal.
Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos
Restart-Computer a ComputerName paraméterrel adja meg a távoli számítógépet, Server01.
A Protocol paraméter a WSMan protokoll használatát határozza meg. A WsmanAuthentication paraméter a hitelesítési módszert Kerberosnéven adja meg.
Paraméterek
-AsJob
Azt jelzi, hogy Restart-Computer háttérfeladatként fut.
A paraméter használatához a helyi és a távoli számítógépeket újra kell konfigurálni. A Windows Vista és a Windows operációs rendszer újabb verzióiban a PowerShellt a Futtatás rendszergazdaként lehetőséggel kell megnyitnia. További információkért lásd: about_Remote_Requirements.
Amikor megadja a AsJob paramétert, a parancs azonnal visszaad egy objektumot, amely a háttérfeladatot jelöli. Folytathatja a munkát a munkamenetben, amíg a feladat befejeződik. A feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat kezeléséhez használja a Feladat parancsmagokat. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.
További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
AsJobSet
| 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 |
-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. Írjon be egy felhasználónevet (például User01, Domain01\User01), vagy írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre.
Ha a Hitelesítő adatok paraméter nincs megadva, Restart-Computer az aktuális felhasználó hitelesítő adatait használja.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| 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 |
-DcomAuthentication
Megadja a WMI-kapcsolathoz használt hitelesítési szintet.
Restart-Computer WMI-t használ.
Az érvényes értékek a következők:
- Hívási: Hívásszintű COM-hitelesítés
- Csatlakozás: Csatlakozásszintű COM-hitelesítés
- alapértelmezett: Windows-hitelesítés
- Nincs: Nincs COM-hitelesítés
- Csomag: Csomagszintű COM-hitelesítés.
- PacketIntegrity: Csomagintegritási szintű COM-hitelesítés
- PacketPrivacy: Packet Privacy szintű COM-hitelesítés.
- Változatlan: A hitelesítési szint megegyezik az előző paranccsal.
További információ: AuthenticationLevel Enumeration.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | AuthenticationLevel |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Hitelesítés |
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 |
-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
DefaultSet
| 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
DefaultSet
| 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 |
-Impersonation
Megadja a parancsmag által a WMI meghívásához használt megszemélyesítési szintet.
Restart-Computer WMI-t használ.
A paraméter elfogadható értékei a következők:
- Alapértelmezett: Alapértelmezett megszemélyesítés. A név ellenére nem ez az alapértelmezett érték.
- Névtelen: Elrejti a hívó identitását.
- azonosítása: Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
- megszemélyesítési: Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
Paramétertulajdonságok
| Típus: | ImpersonationLevel |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, Anonymous, Identify, Impersonate, Delegate |
| 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 |
-Protocol
Megadja, hogy melyik protokollt kell használni a számítógépek újraindításához. Az érvényes értékek WSMan és DCOM.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | DCOM, WSMan |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
DefaultSet
| 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 |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Ha a ThrottleLimit paraméter nincs megadva, vagy 0 értéket használ, Restart-Computer legfeljebb 32 egyidejű kapcsolatot használ.
Paramétertulajdonságok
| Típus: | Int |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
AsJobSet
| 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: | Int |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | TimeoutSec |
Paraméterkészletek
DefaultSet
| 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
DefaultSet
| 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
DefaultSet
| 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
Restart-Computer számítógépneveket fogad el a folyamatból vagy változókból.
A Windows PowerShell 2.0-ban a ComputerName paraméter csak tulajdonságnév alapján veszi fel a bemenetet a folyamatból. A Windows PowerShell 3.0-s és újabb verzióiban a ComputerName paraméter érték szerint veszi fel a bemenetet a folyamatból.
Kimenetek
None, System.Management.Automation.RemotingJob
Ha megadja a AsJob paramétert, Restart-Computer egy feladatobjektumot ad vissza. Ellenkező esetben a rendszer nem hoz létre kimenetet.
Jegyzetek
-
Restart-Computercsak Windows rendszerű számítógépeken működik, és a Rendszer leállításához WinRM és WMI szükséges, beleértve a helyi rendszert is. a Windows Management Instrumentation (WMI) Win32_OperatingSystem osztályWin32Shutdown metódust használja.
A Windows PowerShell 2.0-ban az AsJob paraméter nem működik megbízhatóan távoli számítógépek újraindításakor vagy leállításakor. A Windows PowerShell 3.0-ban az implementáció módosul a probléma megoldásához.