Restart-Computer
Restartuje operační systém na místních a vzdálených počítačích.
Syntax
DefaultSet (Výchozí)
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-WsmanAuthentication <string>]
[-Protocol <string>]
[-Force]
[-Wait]
[-Timeout <int>]
[-For <WaitForServiceTypes>]
[-Delay <int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsJobSet
Restart-Computer
[[-ComputerName] <string[]>]
[[-Credential] <pscredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-Impersonation <ImpersonationLevel>]
[-Force]
[-ThrottleLimit <int>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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í jako úlohy na pozadí, 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.
K restartování počítače můžete použít protokol WS-Management (WSMan), pokud jsou volání modelu DCOM (Distributed Component Object Model) blokovaná, například podnikovou bránou firewall. Další informace viz WS-Management Protokol.
Tato rutina vyžaduje vzdálené komunikace Prostředí Windows PowerShell pouze v případě, že v příkazu použijete parametr AsJob.
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: Restartování počítačů jako úlohy na pozadí
Tyto příkazy spustí příkaz Restart-Computer jako úlohu na pozadí na dvou vzdálených počítačích a pak získají výsledky.
Protože asjob vytvoří úlohu v místním počítači a automaticky vrátí výsledky do místního počítače, můžete spustit Receive-Job jako místní příkaz.
$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job
Restart-Computer používá parametr ComputerName k určení Server01 a Server02. Parametr AsJob spustí příkaz jako úlohu na pozadí. Objekt úlohy je uložen v proměnné $Job.
$Job se odešle kanál do rutiny Receive-Job, která získá výsledky.
Příklad 4: Restartování vzdáleného počítače
Restart-Computer restartuje vzdálený počítač s přizpůsobeným nastavením zosobnění a ověřování.
Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Restart-Computer používá ComputerName parametr k určení Server01. Parametr zosobnění určuje Anonymní, aby se identita žadatele skryla. Parametr DcomAuthentication určuje packetIntegrity jako úroveň ověřování připojení.
Příklad 5: 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í a parametr ThrottleLimit omezuje počet souběžných připojení.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force -ThrottleLimit 10
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. Parametr ThrottleLimit omezuje příkaz na 10 souběžných připojení.
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í protokolu WSMan
Restart-Computer restartuje vzdálený počítač pomocí protokolu WSMan místo výchozího modelu DCOM. 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.
Tato nastavení jsou určená pro podniky, ve kterých se restartování založené na modelu DCOM nezdaří, protože je blokovaný objekt DCOM. Například bránou firewall.
Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos
Restart-Computer používá parametr ComputerName k určení vzdáleného počítače Server01.
Parametr protokolu
Parametry
-AsJob
Označuje, že Restart-Computer běží jako úloha na pozadí.
Chcete-li použít tento parametr, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou komunikace. Ve Windows Vista a novějších verzích operačního systému Windows je nutné otevřít PowerShell pomocí možnosti Spustit jako správce. Další informace naleznete v tématu about_Remote_Requirements.
Když zadáte parametr AsJob, příkaz okamžitě vrátí objekt, který představuje úlohu na pozadí. Během dokončení úlohy můžete pokračovat v práci v relaci. Úloha se vytvoří v místním počítači a výsledky ze vzdálených počítačů se automaticky vrátí do místního počítače. Ke správě úlohy použijte rutiny Úloha. K získání výsledků úlohy použijte rutinu Receive-Job.
Další informace o úlohách prostředí Windows PowerShell na pozadí najdete v tématu about_Jobs a about_Remote_Jobs.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
AsJobSet
| 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 |
-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. Zadejte uživatelské jméno, například User01, Domain01\User01 nebo zadejte PSCredential objekt vygenerovaný rutinou Get-Credential.
Pokud není zadaný parametr přihlašovacích údajů, Restart-Computer použije přihlašovací údaje aktuálního uživatele.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| 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 |
-DcomAuthentication
Určuje úroveň ověřování, která se používá pro připojení rozhraní WMI.
Restart-Computer používá rozhraní WMI.
Platné hodnoty jsou:
- volání: Ověřování modelu COM na úrovni volání
- Connect: Ověřování modelu COM na úrovni připojení
výchozí : Ověřování systému Windows- Žádné: Bez ověřování modelu COM
- paketů: Ověřování modelu COM na úrovni paketů.
- PacketIntegrity: Ověřování modelu COM na úrovni integrity paketů
- packetPrivacy: Ověřování modelu COM na úrovni ochrany osobních údajů paketů.
- beze změny: Úroveň ověřování je stejná jako předchozí příkaz.
Další informace naleznete v tématu AuthenticationLevel Výčet.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | AuthenticationLevel |
| Default value: | None |
| Přípustné hodnoty: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Autentizace |
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 |
-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ů
DefaultSet
| 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ů
DefaultSet
| 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 |
-Impersonation
Určuje úroveň zosobnění, kterou tato rutina používá k volání rozhraní WMI.
Restart-Computer používá rozhraní WMI.
Přijatelné hodnoty pro tento parametr jsou:
- Výchozí: Výchozí zosobnění. Bez ohledu na název to není výchozí hodnota.
- anonymní: Skryje identitu volajícího.
- Identifikovat: Umožňuje objektům dotazovat přihlašovací údaje volajícího.
- zosobnění: Umožňuje objektům používat přihlašovací údaje volajícího.
Vlastnosti parametru
| Typ: | ImpersonationLevel |
| Default value: | None |
| Přípustné hodnoty: | Default, Anonymous, Identify, Impersonate, Delegate |
| 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 |
-Protocol
Určuje protokol, který se má použít k restartování počítačů. Platné hodnoty jsou WSMan a DCOM.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | DCOM, WSMan |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
DefaultSet
| 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 |
-ThrottleLimit
Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu. Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.
Pokud parametr ThrottleLimit není zadaný nebo se použije hodnota 0, Restart-Computer použije maximálně 32 souběžných připojení.
Vlastnosti parametru
| Typ: | Int |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
AsJobSet
| 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: | Int |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | TimeoutSec |
Sady parametrů
DefaultSet
| 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ů
DefaultSet
| 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ů
DefaultSet
| 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
Restart-Computer přijímá názvy počítačů z kanálu nebo proměnných.
V prostředí Windows PowerShell 2.0 přebírá parametr ComputerName vstup z kanálu pouze názvem vlastnosti. Ve Windows PowerShellu 3.0 a novějším přebírá parametr ComputerName vstup z kanálu podle hodnoty.
Výstupy
None, System.Management.Automation.RemotingJob
Pokud zadáte parametr AsJob, Restart-Computer vrátí objekt úlohy. V opačném případě se nevygeneruje žádný výstup.
Poznámky
-
Restart-Computerpracovat jenom na počítačích se systémem Windows a k vypnutí systému, včetně místního systému, vyžaduje WinRM a rozhraní WMI. -
Restart-Computerpoužívá metodu Win32ShutdownWin32_OperatingSystem třídy WMI (Windows Management Instrumentation).
V prostředí Windows PowerShell 2.0 nefunguje parametr AsJob spolehlivě při restartování nebo zastavování vzdálených počítačů. V prostředí Windows PowerShell 3.0 se implementace změní, aby se tento problém vyřešil.