Sdílet prostřednictvím

Restart-Computer

  • Reference
Modul:
Microsoft.PowerShell.Management

Restartuje operační systém na místních a vzdálených počítačích.

Syntaxe

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Restart-Computer restartuje operační systém na místních a vzdálených počítačích.

Parametry Restart-Computer můžete použít ke spuštění operací restartování, k určení úrovní ověřování a alternativních přihlašovacích údajů, k omezení operací spuštěných současně a k vynucení okamžitého restartování.

Počínaje windows PowerShellem 3.0 můžete před spuštěním dalšího příkazu počkat na dokončení restartování. Zadejte časový limit čekání a interval dotazu a počkejte, až budou v restartovaném počítači dostupné konkrétní služby. Díky této funkci je praktické používat Restart-Computer ve skriptech a funkcích.

Příklady

Příklad 1: Restartování místního počítače

Restart-Computer restartuje místní počítač.

Restart-Computer

Příklad 2: Restartování více počítačů

Restart-Computer může restartovat vzdálené a místní počítače. Parametr ComputerName přijímá pole názvů počítačů.

Restart-Computer -ComputerName Server01, Server02, localhost

Příklad 3: Získání názvů počítačů z textového souboru

Restart-Computer získá seznam názvů počítačů z textového souboru a restartuje počítače. Parametr ComputerName není zadaný. Protože je to ale první pozicový parametr, přijímá názvy počítačů z textového souboru, které se posílají do potrubí.

Get-Content -Path C:\Domain01.txt | Restart-Computer

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čů se odesílají do datového toku. Restart-Computer restartuje každý počítač.

Příklad 4: Vynucení restartování počítačů uvedených v textovém souboru

Tento příklad vynutí okamžité restartování počítačů uvedených v souboru Domain01.txt. Názvy počítačů z textového souboru jsou uloženy v proměnné. Parametr Force vynutí okamžité restartování.

$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force

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é $Names. Get-Credential vás vyzve k zadání uživatelského jména a hesla a uloží hodnoty do proměnné $Creds. Restart-Computer používá parametry ComputerName a credential s jejich proměnnými. Parametr Force způsobí okamžité restartování každého počítače.

Příklad 6: Restartování vzdáleného počítače a čekání na PowerShell

Restart-Computer restartuje vzdálený počítač a potom počká až 5 minut (300 sekund), než bude PowerShell dostupný na restartovaném počítači, než bude pokračovat.

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer používá ComputerName parametr k určení Server01. Parametr Wait čeká na dokončení restartování. Pro určuje, že PowerShell může spouštět příkazy na vzdáleném počítači. Parametr časového limitu určuje 5minutové čekání. Parametr Delay každých dvě sekundy dotazuje vzdálený počítač, aby zjistil, jestli se restartuje.

Příklad 7: Restartování počítače pomocí WsmanAuthentication

Restart-Computer restartuje vzdálený počítač pomocí mechanismu WsmanAuthentication. Ověřování protokolem Kerberos určuje, jestli má aktuální uživatel oprávnění k restartování vzdáleného počítače. Další informace viz AuthenticationMechanism.

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-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

-ComputerName

Určuje jeden název počítače nebo názvy počítačů v poli oddělené čárkami. Restart-Computer přijímá objekty ComputerName z potrubí nebo ze proměnných.

Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény vzdáleného počítače. Chcete-li zadat místní počítač, zadejte název počítače, tečku .nebo localhost.

Tento parametr nespoléhá na vzdálenou komunikaci PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Pokud není zadaný parametr ComputerName, Restart-Computer restartuje místní počítač.

Typ:String[]
Aliasy:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním Restart-Computervás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Výchozí hodnota je aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Přihlašovací údaje jsou uloženy v objektu PSCredential a heslo je uloženo jako SecureString.

Poznámka

Další informace o ochraně dat SecureString najdete v tématu Jak zabezpečený je SecureString?.

Typ:PSCredential
Position:1
Default value:Current user
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Delay

Určuje frekvenci dotazů v sekundách. PowerShell dotazuje službu určenou parametrem For a určí, jestli je služba dostupná po restartování počítače.

Tento parametr je platný pouze společně s parametry Wait a For.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Pokud parametr Delay není zadaný, Restart-Computer použije pět sekund zpoždění.

Typ:Int16
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-For

Určuje chování PowerShellu, když po restartování počítače počká, až bude zadaná služba nebo funkce k dispozici. Tento parametr je platný pouze s parametrem Wait.

Přijatelné hodnoty pro tento parametr jsou:

  • výchozí: Čeká na restartování PowerShellu.
  • PowerShell: Může na počítači spouštět příkazy ve vzdálené relaci PowerShellu.
  • WMI: Přijímá odpověď na počítačový dotaz Win32_ComputerSystem.
  • WinRM: Může vytvořit vzdálenou relaci k počítači pomocí protokolu WS-Management.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:WaitForServiceTypes
Přípustné hodnoty:Wmi, WinRM, PowerShell
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí okamžité restartování počítače.

Typ:SwitchParameter
Aliasy:f
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Timeout

Určuje dobu čekání v sekundách. Po uplynutí časového limitu se Restart-Computer vrátí do příkazového řádku, i když se počítače nerestartují.

Parametr Vypršení časového limitu je platný pouze s parametrem Wait. Časový limit přepíše časově neomezenou dobu čekání parametru "Wait".

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:Int32
Aliasy:TimeoutSec
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Wait

Restart-Computer potlačí příkazový řádek PowerShellu a blokuje kanál, dokud se počítače nerestartují. Tento parametr můžete použít ve skriptu k restartování počítačů a po dokončení restartování pokračovat v procesu.

Parametr Wait čeká po neomezenou dobu, než se počítače restartují. Pomocí časového limitu můžete upravit časování a parametry Pro a Delay pro čekání, až se konkrétní služby zpřístupní na restartovaných počítačích.

Parametr Wait není platný při restartování místního počítače. Pokud hodnota parametru ComputerName obsahuje názvy vzdálených počítačů a místního počítače, Restart-Computer vygeneruje neukončující chybu pro Wait v místním počítači, ale čeká na restartování vzdálených počítačů.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se Restart-Computer spustí. Příkaz Restart-Computer není spuštěn.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WsmanAuthentication

Určuje mechanismus, který se používá k ověření přihlašovacích údajů uživatele. Tento parametr byl představen ve Windows PowerShellu 3.0.

Přijatelné hodnoty pro tento parametr jsou: Basic, CredSSP, Výchozí, Digest, Kerberosa Negotiate.

Další informace viz AuthenticationMechanism.

Varování

Ověřování poskytovatele služeb zabezpečení pověření (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači k ověření, je navrženo pro příkazy, které vyžadují ověření na více než jednom prostředku, například při přístupu ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Typ:String
Přípustné hodnoty:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Do tohoto appletu můžete poslat řetězec, který obsahuje název počítače.

Výstupy

None

Tento cmdlet nevrátí žádný výstup.

Poznámky

  • Ve Windows Restart-Computer používá metodu Win32ShutdownWin32_OperatingSystem třídy WMI (Windows Management Instrumentation). Tato metoda vyžaduje povolení oprávnění SeShutdownPrivilege pro uživatelský účet použitý k restartování počítače.
  • V Linuxu a macOS Restart-Computer používá nástroj /sbin/shutdown Bash.