Stop-Computer
Zastaví (vypne) místní a vzdálené počítače.
Syntax
Default (Výchozí)
Stop-Computer
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Stop-Computer vzdáleně vypne počítače. Může také vypnout místní počítač.
Pomocí parametrů zastavit počítač spustit operace vypnutí jako úlohu na pozadí, určit úrovně ověřování a alternativní přihlašovací údaje, omezit souběžná připojení vytvořená ke spuštění příkazu a vynutit okamžité vypnutí.
Tato rutina nevyžaduje vzdálené komunikace Prostředí Windows PowerShell, pokud nepoužíváte parametr AsJob.
Příklady
Příklad 1: Vypnutí místního počítače
PS C:\> Stop-Computer
Tento příkaz vypne místní počítač.
Příklad 2: Vypnutí dvou vzdálených počítačů a místního počítače
PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Tento příkaz zastaví dva vzdálené počítače, Server01 a Server02 a místní počítač identifikovaný jako localhost.
Příklad 3: Vypnutí vzdálených počítačů jako úlohy na pozadí
PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results
Tyto příkazy spustí zastavit počítač jako úlohu na pozadí na dvou vzdálených počítačích a pak získají výsledky.
První příkaz určuje parametr AsJob ke spuštění příkazu jako úlohu na pozadí. Příkaz uloží výsledný objekt úlohy do proměnné $j.
Druhý příkaz používá operátor kanálu k odeslání objektu úlohy v $j do receive-job, který získá výsledky úlohy. Příkaz uloží výsledky do proměnné $results.
Třetí příkaz zobrazí výsledek uložený v proměnné $results.
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 úloha příjmu jako místní příkaz.
Příklad 4: Vypnutí vzdáleného počítače
PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity
Tento příkaz zastaví vzdálený počítač Serveru01. Příkaz používá vlastní nastavení zosobnění a ověřování.
Příklad 5:
PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
Tyto příkazy vynutí okamžité vypnutí všech počítačů v doméně Domain01.
První příkaz získá seznam počítačů v doméně a pak je uloží do proměnné $s.
Druhý příkaz získá přihlašovací údaje správce domény a pak je uloží do proměnné $c.
Třetí příkaz vypne počítače. Pomocí parametru ComputerName odešle seznam počítačů v proměnné $s, parametr Vynucení vynucení okamžitého vypnutí a parametr přihlašovacích údajů k odeslání přihlašovacích údajů uložených v proměnné $c. Používá také parametr ThrottleLimit k omezení příkazu na 10 souběžných připojení.
Parametry
-AsJob
Označuje, že tato rutina 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 a v systému Windows Vista a novějších verzích operačního systému Windows je nutné otevřít Prostředí Windows PowerShell pomocí možnosti Spustit jako správce. Další informace najdete 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. 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ů
(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 |
-ComputerName
Určuje počítače, které se mají zastavit. Výchozí hodnota je místní počítač.
Do seznamu oddělených čárkami zadejte název NETBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů. Chcete-li zadat místní počítač, zadejte název počítače nebo localhost.
Tento parametr nespoléhá na vzdálené komunikace Windows PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný pro spouštění vzdálených příkazů.
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: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vá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, například objekt z rutiny Get-Credential.
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í, kterou tato rutina používá s rozhraním WMI. stop-computer používá rozhraní WMI. Přijatelné hodnoty pro tento parametr jsou:
- Výchozí. Ověřování systému Windows
- Žádné. Bez ověřování modelu COM
- Připojit. Ověřování modelu COM na úrovni připojení
- Zavolat. Ověřování modelu COM na úrovni volání
- Balíček. Ověřování modelu COM na úrovni paketů
- Integrita paketu. Ověřování modelu COM na úrovni integrity paketů
- Ochrana osobních údajů paketů. Ověřování modelu COM na úrovni ochrany osobních údajů paketů
- Nezměněný. Stejné jako předchozí příkaz
Výchozí hodnota je Packet.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationLevel Výčet v knihovně MSDN.
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 |
-Force
Vynutí okamžité vypnutí počítačů.
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 |
-Impersonation
Určuje úroveň zosobnění, která se má použít, když tato rutina volá rozhraní WMI. stop-computer používá rozhraní WMI. Přijatelné hodnoty pro tento parametr jsou:
- Výchozí. Výchozí zosobnění
- Anonymní. Skryje identitu volajícího.
- Identifikovat. Umožňuje objektům dotazovat přihlašovací údaje volajícího.
- Zosobňovat. Umožňuje objektům používat přihlašovací údaje volajícího.
Výchozí hodnota je Zosobnění.
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čů. Přijatelné hodnoty pro tento parametr jsou: WSMan a DCOM. Výchozí hodnota je DCOM.
Tento parametr byl představen 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ů
(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 |
-ThrottleLimit
Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, použije se výchozí hodnota 32.
Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.
Vlastnosti parametru
| Typ: | Int32 |
| 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 příkaz spustí. Příkazový modul nebyl 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, když tato rutina používá protokol WSMan. Přijatelné hodnoty pro tento parametr jsou:
- Basic
- CredSSP
- Výchozí
- Přehled
- Kerberos
- Vyjednávat.
Výchozí hodnota je Default.
Další informace o hodnotách tohoto parametru najdete v tématu AuthenticationMechanism – výčet v knihovně MSDN.
Upozornění: 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, jako je například 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.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 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
None
Vstup do této rutiny nelze převést.
Výstupy
None or System.Management.Automation.RemotingJob
Rutina vrátí objekt System.Management.Automation.RemotingJob, pokud zadáte parametr AsJob. Jinak nevygeneruje žádný výstup.
Poznámky
- Tato rutina používá metodu Win32Shutdown třídy Win32_OperatingSystem WMI.
- 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.