Stop-Computer
Zastaví (vypne) místní a vzdálené počítače.
Syntax
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Stop-Computer vypne místní počítač a vzdálené počítače.
Parametry můžete použít Stop-Computer k určení úrovní ověřování a alternativních přihlašovacích údajů a k vynucení okamžitého vypnutí.
V PowerShellu 7.1 Stop-Computer byl přidán pro Linux a macOS. Platformy, které nejsou Windows, mají pouze parametry CoIf, Confirm a CommonParameters. Rutina právě volá nativní příkaz /sbin/shutdown.
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 se spustí jako úloha na pozadí na dvou vzdálených počítačích.
Operátor & pozadí spustí Stop-Computer příkaz jako úlohu na pozadí. Další informace najdete na about_Operators.
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer používá parametr ComputerName k určení dvou vzdálených počítačů. Operátor & pozadí spustí příkaz jako úlohu na pozadí. Objekty úlohy jsou uloženy v $j proměnné.
Objekty úlohy v $j proměnné se odesílají do kanálu, do Receive-Jobkterého se načte výsledky úlohy. Objekty jsou uloženy v proměnné $results. Proměnná $results zobrazí informace o úloze v konzole PowerShellu.
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" -WsmanAuthentication Kerberos
Stop-Computer používá parametr ComputerName k určení vzdáleného počítače. Parametr WsmanAuthentication určuje použití protokolu Kerberos k navázání vzdáleného připojení.
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 -Credential $c
Get-Content pomocí parametru Path získá soubor 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 Credential k určení přihlašovacích údajů správce domény. Přihlašovací údaje jsou uloženy v $c proměnné.
Stop-Computer vypne počítače zadané pomocí seznamu počítačů parametru ComputerName v $s proměnné. Parametr Force vynutí okamžité vypnutí. Parametr Credential odešle přihlašovací údaje uložené v $c proměnné.
Parametry
-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.
Tento parametr je k dispozici pouze na Windows platformách.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | CN, __SERVER, 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.
Note
Další informace o ochraně dat SecureString najdete v tématu Jak zabezpečený je SecureString?.
Tento parametr je k dispozici pouze na Windows platformách.
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 |
-Force
Vynutí okamžité vypnutí počítače.
Tento parametr je k dispozici pouze na Windows platformách.
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 |
-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í
- Digest
- Kerberos
- Vyjednávat.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism.
Caution
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.
Tento parametr byl představen v PowerShellu 3.0. Tento parametr je k dispozici pouze na Windows platformách.
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
Tento cmdlet nevrátí žádný výstup.
Poznámky
Tato rutina používá metodu Win32Shutdown třídy Win32_OperatingSystem WMI. Tato metoda vyžaduje SeShutdownPrivilege povolení oprávnění pro uživatelský účet použitý k vypnutí počítače.
V PowerShellu 7.1 Stop-Computer byl přidán pro Linux a macOS. Pro tyto platformy rutina volá nativní příkaz /sbin/shutdown.
