restartuje operační systém na lokálních a vzdálených počítačích.
- syntaxe
- popis
- Příklady
- Příklad 1: Restartování místního počítače
- Příklad 2: Restartujte více počítačů
- Příklad 3: Získat názvy počítačů z textového souboru
- Příklad 4: vynucení restartování počítače uvedeny v textovém souboru
- Příklad 6: Restartujte vzdálený počítač a čekat na PowerShell
- Příklad 7: Restartování počítače pomocí WsmanAuthentication
- parametry
- Inputs
- Outputs
- Poznámky
syntaxe
popis
rutinaRestart-Computer restartuje operační systém na lokálních a vzdálených počítačích.
můžete použít parametry Restart-Computer spustit restartování operace, určit theauthentication úrovně a alternativní pověření, omezit operace, které běží ve stejnou dobu,a vynutit okamžitý restart.
počínaje Windows PowerShell 3.0 můžete počkat na dokončení restartu, než spustíte příkaz nextcommand. Zadejte čekací doba-a dotazu intervalu, a čekat na konkrétní služby také na restartování počítače. Tato funkce umožňuje praktické použitíRestart-Computer nápisy a funkce.
Příklady
Příklad 1: Restartování místního počítače
Restart-Computer restartuje místní počítač.
Restart-ComputerPříklad 2: Restartujte více počítačů
Restart-Computer může restart vzdáleného a místního počítače. Parametr ComputerName přijímá anarray názvů počítačů.
Restart-Computer -ComputerName Server01, Server02, localhostPříklad 3: Získat názvy počítačů z textového souboru
Restart-Computer získá seznam názvy počítačů z textového souboru a restartování počítače. Parametr computername není zadán. Ale protože je to parametr první pozice, je topřijímá názvy počítačů z textového souboru, který je odeslán potrubím.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content používá parametr Path získat seznam názvů počítačů z textového souboru,Domain01.txt. Názvy počítačů jsou posílány potrubím. Restart-Computer restartuje každýpočítač.
Příklad 4: vynucení restartování počítače uvedeny v textovém souboru
Tento příklad síly okamžité restartování počítače uvedené v Domain01.txt soubor. Thejména počítačů z textového souboru jsou uložena v proměnné. Parametr síly vynutí okamžitý restart.
Get-Content používá parametr Path k získání seznamu názvů počítačů z textového souboru Domain01.txt. Názvy počítačů jsou uloženy v proměnné $NamesGet-Credential vybízí k zadání uživatelského jména a hesla a ukládá hodnoty do proměnné $CredsRestart-Computerpoužívá parametry ComputerName a Credential s jejich proměnnými. Forceparameter způsobí okamžitý restart každého počítače.
Příklad 6: Restartujte vzdálený počítač a čekat na PowerShell
Restart-Computer restartuje vzdálený počítač, a pak čeká, až 5 minut (300 sekund) forPowerShell, aby se stal k dispozici na restartování počítače před tím, než pokračuje.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer používá parametr ComputerName k určení Server01. Waitparameter čeká na dokončení restartu. For určuje, že PowerShell může spouštět příkazyvzdáleném počítači. Parametr Timeout určuje pětiminutové čekání. Parametr Zpožděnípožaduje vzdálený počítač každé dvě sekundy, aby zjistil, zda je restartován.
Příklad 7: Restartování počítače pomocí WsmanAuthentication
Restart-Computer restartuje vzdálený počítač pomocí WsmanAuthentication mechanismus.Ověření Kerberos určuje, zda má Aktuální uživatel oprávnění restartovat remotecomputer. Pro více informací, vizauthenticationmechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer používá parametr ComputerName k určení vzdáleného počítače, Server01.Parametr WsmanAuthentication určuje metodu ověřování jako Kerberos.
parametry
určuje jeden název počítače nebo pole názvů počítačů oddělené čárkami. Restart-Computer přijímá objekty počítače z potrubí nebo proměnných.
zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény vzdáleného počítače. Chcete-lispecifikovat místní počítač, zadejte název počítače, tečku . nebo localhost.
tento parametr se nespoléhá na dálkové ovládání PowerShell. Můžete použít ComputerName parametr, i váš počítač není nakonfigurován pro spuštění vzdálené příkazy.
Pokud parametr ComputerName není zadán,Restart-Computer restartuje místní počítač.
| Typ: | String |
| Aliasů: | KN, __SERVER, Server, ip adresa |
| Pozice: | 0 |
| Výchozí hodnoty: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Určuje uživatelský účet, který má oprávnění k tomuto úkonu. Výchozí je aktuální uživatel.
Zadejte uživatelské jméno, jako Uživatel01 nebo Domain01\Uživatel01, nebo zadejte PSCredential objectgenerated Get-Credential rutiny. Pokud zadáte uživatelské jméno, budete vyzváni k zadáníheslo.
přihlašovací údaje jsou uloženy v PSCredentialobject a heslo je uloženo jako SecureString.
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. PowerShell dotazuje službu zadanou parametrem theFor, aby určil, zda je služba k dispozici po restartování počítače.
tento parametr je platný pouze společně s parametry Wait a For.
tento parametr byl zaveden v systému Windows PowerShell 3.0.
Pokud parametr zpoždění není zadán, Restart-Computer použije pětisekundové zpoždění.
| Typ: | Int16 |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje chování PowerShell jako to čeká na specifikovanou službu nebo funkci becomeavailable po restartování počítače. Tento parametr je platný pouze s parametrem Wait.
přijatelné hodnoty pro tento parametr jsou:
- výchozí: čeká na restart PowerShell.
- PowerShell: může spouštět příkazy ve vzdálené relaci PowerShell v počítači.
- WMI: Obdrží odpověď na dotaz Win32_ComputerSystem pro počítač.
- WinRM: může vytvořit vzdálenou relaci k počítači pomocí WS-Management.
tento parametr byl zaveden v systému Windows PowerShell 3.0.
| Typ: | WaitForServiceTypes |
| povolené hodnoty: | Wmi, WinRM, PowerShell |
| Pozice: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. Po uplynutí časového limitu se Restart-Computer vrátí do příkazového řádku, i když počítače nejsou restartovány.
parametr Timeout je platný pouze s parametrem Wait. Timeout přepíše neurčitou čekací dobu parametru wait.
tento parametr byl zaveden v systému Windows PowerShell 3.0.
| Typ: | Int32 |
| Aliasů: | TimeoutSec |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Restart-Computer potlačuje PowerShell řádku a bloky potrubí do počítače haverestarted. Tento parametr můžete použít ve skriptu k restartování počítačů a poté pokračovat v procesupo dokončení restartu.
parametr Wait čeká neomezeně dlouho, než se počítače restartují. Timeout můžete použít k nastavení časování a parametrů For a Delay a čekat, až se konkrétní služby stanou dostupnými na restartovaných počítačích.
parametr Wait není platný při restartování místního počítače. Pokud hodnota theComputerName parametr obsahuje názvy vzdálených počítačích a místního počítače,Restart-Computer vytváří non-zastavení chyba Čekat na lokálním počítači, ale waitsfor vzdáleného počítače restartovat.
tento parametr byl zaveden v systému Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Jménem |
| Výchozí hodnota: | False |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje mechanismus, který se používá k ověření uživatele pověření. Tento parametr bylzavedeno v systému Windows PowerShell 3.0.
přijatelné hodnoty pro tento parametr jsou: Basic, CredSSP, Default,Digest, Kerberos a Negotiate.
Více informací vizauthenticationmechanism.
Upozornění
Pověření Security Service Provider (CredSSP) ověřování, ve kterém pověření uživatele arepassed ke vzdálenému počítači musí být ověřen, je určen pro příkazy, které requireauthentication na více než jednoho zdroje, jako je například přístup k vzdálené síti sdílet. Tento mechanismuszvyšuje bezpečnostní riziko vzdáleného provozu. Pokud je vzdálený počítač ohrožen, kredenciály, které jsou mu předány, lze použít k řízení síťové relace.
| Typ: | String |
| povolené hodnoty: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
Poznámky
- Okna
Restart-Computerpoužívá Win32Shutdown ukládání Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Tato metoda vyžaduje povolení oprávnění SeShutdownPrivilege pro uživatelský účetpoužitý k restartování počítače. - v systémech Linux a Mac OS používá
Restart-Computernástroj/sbin/shutdownBash.
- o vzdálené správě systému Windows
- Get-Credential
- WS-Management Protocol