Stop-Computer
Zastaví (vypne) místní a vzdálené počítače.
Syntax
Stop-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Stop-Computer
vypne místní 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
byla přidána funkce pro Linux a macOS. Parametry nemají na tyto platformy žádný vliv. 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 se Stop-Computer
nástroj 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 v tématu 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 , Receive-Job
který získá výsledky úlohy. Objekty jsou uloženy v $results
proměnné . 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
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 $s
proměnné .
Get-Credential
používá parametr Credential k určení přihlašovacích údajů správce domény. Přihlašovací údaje jsou uložené v $c
proměnné .
Stop-Computer
vypne počítače zadané pomocí seznamu počítačů v 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í hodnotou je místní počítač.
Do seznamu odděleného čárkami zadejte název rozhraní NETBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů. Pokud chcete zadat místní počítač, zadejte název počítače nebo localhost.
Tento parametr nespoléhá na vzdálené komunikace PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný ke spouštění vzdálených příkazů.
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to 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?.
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Vynutí okamžité vypnutí počítače.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Výchozí.
Tento parametr přijímá tyto hodnoty:
- Basic
- CredSSP
- Default
- Digest
- Kerberos
- Vyjednávat.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism.
Upozornění
Ověřování credSSP (Credential Security Service Provider), při kterém se přihlašovací údaje uživatele předávají vzdálenému počítači k ověření, je určeno pro příkazy, které vyžadují ověření u více než jednoho prostředku, jako je například přístup ke vzdálené sdílené síťové složce. Tento mechanismus zvyšuje bezpečnostní riziko vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, mohou být k řízení síťové relace použity přihlašovací údaje, které jsou mu předány.
Tento parametr byl zaveden v PowerShellu 3.0.
Type: | String |
Accepted values: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None
Objekty nelze do této rutiny převést.
Výstupy
None
Tato rutina nevrací žádný výstup.
Poznámky
Tato rutina používáWin32Shutdown
Win32_OperatingSystem
třídy služby 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
byla přidána funkce pro Linux a macOS. Pro tyto platformy rutina volá nativní příkaz /sbin/shutdown
.