Restart-Computer

Modul:

Microsoft.PowerShell.Management Module

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

Syntax

DefaultSet (Výchozí)

Restart-Computer
    [[-ComputerName] <String[]>]
    [-WsmanAuthentication <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č.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Čína, __SERVER, počítačový server, IP adresa

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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?.

Vlastnosti parametru

Typ:	PSCredential
Default value:	Current user
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	Int16
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	WaitForServiceTypes
Default value:	None
Přípustné hodnoty:	Wmi, WinRM, PowerShell
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	f

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	TimeoutSec

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Výstraha

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.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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 systému Linux a Mac OS používá Restart-Computer nástroj /sbin/shutdown Bash.

Související odkazy

• Informace o vzdálené správě systému Windows
• Get-Credential
• protokol WS-Management