Stop-Computer
Zastaví (vypne) místní a vzdálené počítače.
Syntax
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Stop-Computer vypne místní počítač a vzdálené počítače.
Parametry Stop-Computer můžete použít ke spuštění operací vypnutí jako úlohy na pozadí, k určení úrovní ověřování a alternativních přihlašovacích údajů, k omezení souběžných připojení vytvořených ke spuštění příkazu a k vynucení okamžitého vypnutí.
Tato rutina nevyžaduje vzdálené komunikace PowerShellu, pokud nepoužíváte parametr AsJob.
Příklady
Příklad 1: Vypnutí místního počítače
Tento příklad vypne místní počítač.
Stop-Computer -ComputerName localhost
Příklad 2: Vypnutí dvou vzdálených počítačů a místního počítače
Tento příklad zastaví dva vzdálené počítače a místní počítač.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer používá parametr ComputerName k určení dvou vzdálených počítačů a místního počítače. Každý počítač je vypnutý.
Příklad 3: Vypnutí vzdálených počítačů jako úlohy na pozadí
V tomto příkladu Stop-Computer běží jako úloha na pozadí na dvou vzdálených počítačích.
$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results
Stop-Computer používá parametr ComputerName k určení dvou vzdálených počítačů. Parametr AsJob spustí příkaz jako úlohu na pozadí. Objekty úlohy jsou uloženy v proměnné $j.
Objekty úlohy v proměnné $j se odesílají do kanálu do Receive-Job, což získá výsledky úlohy. Objekty jsou uloženy v proměnné $results. Proměnná $results zobrazí informace o úloze v konzole PowerShellu.
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.
Příklad 4: Vypnutí vzdáleného počítače
Tento příklad vypne vzdálený počítač pomocí zadaného ověřování.
Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Stop-Computer k určení vzdáleného počítače používá parametr ComputerName. Parametr zosobnění určuje vlastní zosobnění a parametr DcomAuthentication určuje nastavení na úrovni ověřování.
Příklad 5: Vypnutí počítačů v doméně
V tomto příkladu příkazy vynutí okamžité vypnutí všech počítačů v zadané doméně.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
Get-Content používá parametr Path k získání souboru v aktuálním adresáři se seznamem počítačů domény. Objekty jsou uloženy v proměnné $s.
Get-Credential používá parametr přihlašovacích údajů k určení přihlašovacích údajů správce domény. Přihlašovací údaje jsou uloženy v proměnné $c.
Stop-Computer vypne počítače zadané pomocí ComputerName seznamu počítačů v proměnné $s. Parametr Force vynutí okamžité vypnutí. Parametr ThrottleLimit omezuje příkaz na 10 souběžných připojení. Parametr přihlašovacích údajů odešle přihlašovací údaje uložené v proměnné $c.
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 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. K získání výsledků úlohy použijte rutinu Receive-Job.
Další informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs a about_Remote_Jobs.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| 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á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.
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 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 |
-DcomAuthentication
Určuje úroveň ověřování, kterou tato rutina používá s rozhraním WMI.
Stop-Computer používá rozhraní WMI. Výchozí hodnota je packet.
Přijatelné hodnoty pro tento parametr jsou:
- výchozí
: Ověřování systému Windows. - Žádné: Žádné ověřování modelu COM.
- Connect: Ověřování modelu COM na úrovni připojení.
- volání: Ověřování modelu COM na úrovni volání.
- 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: Stejné jako předchozí příkaz.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationLevel.
Vlastnosti parametru
| Typ: | AuthenticationLevel |
| Default value: | Packet |
| 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če.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| 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. Výchozí hodnota je zosobnit.
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.
- zosobnění: Umožňuje objektům používat přihlašovací údaje volajícího.
Vlastnosti parametru
| Typ: | ImpersonationLevel |
| Default value: | Impersonate |
| 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 modelu DCOM .
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | DCOM |
| 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í. Cmdlet se nespustil.
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. Výchozí hodnota je Default.
Přijatelné hodnoty pro tento parametr jsou:
- Basic
- CredSSP
- Výchozí
- Přehled
- Kerberos
- Vyjednávat.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism.
Upozorně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.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | Default |
| 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
Do tohoto cmdletu nemůžete předávat objekty.
Výstupy
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
System.Management.Automation.RemotingJob
Pokud použijete parametr AsJob, vrátí tato rutina objekt RemotingJob.
Poznámky
Tato rutina používá metodu Win32Shutdown třídy Win32_OperatingSystem WMI. Tato metoda vyžaduje povolení oprávnění SeShutdownPrivilege pro uživatelský účet použitý k vypnutí počítače.
