Restart-Computer

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntax

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 spuštění operací restartování můžete použít Restart-Computer 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. Tato funkce usnadňuje použití 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í zadán. Protože je to ale první parametr pozice, přijímá názvy počítačů z textového souboru, které se odesílají do kanálu.

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

Get-Content pomocí parametru Path získá seznam názvů počítačů z textového souboru Domain01.txt. Názvy počítačů se odesílají do kanálu. 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 Domain01.txt souboru. 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 pomocí parametru Path získá seznam 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-Computerpouží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-Computerpoužívá parametr ComputerName k určení Serveru01. Parametr Wait čeká na dokončení restartování. Hodnota For 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 naleznete v tématu AuthenticationMechanism.

Restart-Computer -ComputerName Server01 -WsmanAuthentication Kerberos

Restart-Computerpouží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 pole počítačů oddělených čárkami. Restart-Computer přijímá objekty ComputerName z kanálu nebo 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álené komunikace 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č.

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinouGet-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 naleznete v tématu Jak zabezpečený je SecureString?.

Type:PSCredential
Position:1
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Delay

Určuje frekvenci dotazů v sekundách. PowerShell dotazuje službu určenou parametrem For , aby určila, 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í.

Type:Int16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Tento parametr přijímá tyto hodnoty:

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

Tento parametr byl představen ve Windows PowerShellu 3.0.

Type:WaitForServiceTypes
Accepted values:Wmi, WinRM, PowerShell
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Aliases:f
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Timeout

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

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

Tento parametr byl představen ve Windows PowerShellu 3.0.

Type:Int32
Aliases:TimeoutSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

Restart-Computer potlačí příkazový řádek PowerShellu a zablokuje 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 počká na restartování počítačů po neomezenou dobu. Časový limit můžete použít k úpravě časování a parametrů For a Delay a čekat na zpřístupnění konkrétních služeb 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 čekání na 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Ukazuje, co se stane, když se Restart-Computer spustí. Rutina Restart-Computer se nespustí.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Default, Digest, Kerberos a Negotiate.

Další informace naleznete v tématu AuthenticationMechanism.

Upozorňující

Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup 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.

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

Vstupy

String

Do této rutiny můžete zamísit řetězec, který obsahuje název počítače.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

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