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
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.
Az újraindítási Restart-Computer műveletek futtatásához, a hitelesítési szintek és a másodlagos hitelesítő adatok megadásához, az egyidejűleg futó műveletek korlátozásához és az azonnali újraindítás kényszerítéséhez használhatja a paramétereket.
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 szkriptekben és függvényekben való használatot Restart-Computer .
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-Computer2. példa: Több számítógép újraindítása
Restart-Computer távoli és helyi számítógépeket is újraindíthat. A ComputerName paraméter egy számítógépnévtömböt fogad el.
Restart-Computer -ComputerName Server01, Server02, localhost3. 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. Nincs megadva a ComputerName paraméter. 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-ComputerGet-ContentA Path paraméterrel lekérheti a számítógépnevek listáját egy szövegfájlból, Domain01.txt. A rendszer elküldi a számítógépneveket a folyamatnak. 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 fájlban felsorolt számítógépek azonnali újraindítását kényszeríti Domain01.txt 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 -ForceGet-ContentA Path paraméterrel lekérheti a számítógépnevek listáját egy szövegfájlból, Domain01.txt. A számítógépnevek a változóban $Namesvannak tárolva. Get-Credential kéri a felhasználónevet és a jelszót, és tárolja az értékeket a változóban $Creds. Restart-ComputerA ComputerName és a Credential paramétereket a változókkal együtt használja. 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 2Restart-ComputerA ComputerName paraméterrel adja meg a Server01 értéket. A Várakozás paraméter megvárja az újraindítás befejezését. A For azt határozza meg, hogy a PowerShell futtathat-e parancsokat a távoli számítógépen. Az Időtúllépés paraméter öt perces várakozást ad 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-ComputerA 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ó: AuthenticationMechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-ComputerA ComputerName paraméterrel adja meg a server01 távoli számítógépet.
A WsmanAuthentication paraméter Kerberosként adja meg a hitelesítési módszert.
Paraméterek
-ComputerName
Egy számítógépnevet vagy számítógépnevek vesszővel tagolt tömbét adja meg. Restart-ComputerComputerName objektumokat fogad el 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 pont vagy .localhost nevet.
Ez a paraméter nem támaszkodik a PowerShell-újraegyezésre. Akkor is használhatja a ComputerName paramétert, 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 indítsa újra a helyi számítógépet.
| Type: | String[] |
| Aliases: | CN, __SERVER, Server, IPAddress |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Megerősítést kér a futtatás Restart-Computerelőtt.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Alapértelmezés szerint az aktuális felhasználó.
Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.
Feljegyzés
További információ a SecureString adatvédelemről: Mennyire biztonságos a SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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éterrel 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.
| Type: | Int16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-For
A PowerShell viselkedését adja meg, amíg a megadott szolgáltatás vagy szolgáltatás 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: Futtathat parancsokat egy Távoli PowerShell-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.
| Type: | WaitForServiceTypes |
| Accepted values: | Wmi, WinRM, PowerShell |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Kényszeríti a számítógép azonnali újraindítását.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Wait paraméterrel érvényes. Az időtúllépés felülbírálja a Wait paraméter határozatlan ideig tartó várakozási idejét.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
| Type: | Int32 |
| Aliases: | TimeoutSec |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Várakozás paraméter határozatlan ideig várakozik, amíg a számítógépek újraindulnak. Az időtúllépéssel módosíthatja az időzítést és a For és a Delay paramétereket, hogy megvárja, amíg bizonyos szolgáltatások elérhetővé válnak az újraindított számítógépeken.
A Wait 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 számítógépek és a helyi számítógép nevét, Restart-Computer nem végződő hibát okoz a helyi számítógépen való várakozáskor, 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Megjeleníti, mi történne, ha a Restart-Computer futtatások történnek. A Restart-Computer parancsmag nem fut.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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: Basic, CredSSP, Default, Digest, Kerberos és Negotiate.
További információ: 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.
| Type: | String |
| Accepted values: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Bevitelek
Erre a parancsmagra egy számítógépnevet tartalmazó sztringet csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
- Windows
Restart-Computerrendszerben a Windows Management Instrumentation (WMI) Win32_OperatingSystem osztály Win32Shutdown metódusát 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. - Linuxon és Mac OS-en
Restart-Computerhasználja a/sbin/shutdownbash eszközt.
Kapcsolódó hivatkozások
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: