Sdílet prostřednictvím


Stop-Computer

Zastaví (vypne) místní a vzdálené počítače.

Syntaxe

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-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 k určení úrovní ověřování a alternativních přihlašovacích údajů a vynucení okamžitého vypnutí.

V PowerShellu 7.1 se Stop-Computer přidal 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 Stop-Computer běží jako úloha na pozadí na dvou vzdálených počítačích.

Operátor pozadí & spustí příkaz Stop-Computer 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 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.

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 k určení vzdáleného počítače používá parametr ComputerName. 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 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 přihlašovacích údajů odešle přihlašovací údaje uložené v proměnné $c.

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álené komunikace 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.

Typ:String[]
Aliasy:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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?.

Typ:PSCredential
Position:1
Default value:Current user
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí okamžité vypnutí počítače.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Přijatelné hodnoty pro tento parametr jsou:

  • Základní
  • CredSSP
  • Výchozí
  • Trávit
  • Kerberos
  • Vyjednávat.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism.

Opatrnost

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.

Typ:String
Přípustné hodnoty:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:Default
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Tato rutina používá Win32Shutdown metodu Win32_OperatingSystem třídy WMI. Tato metoda vyžaduje povolení oprávnění SeShutdownPrivilege pro uživatelský účet použitý k vypnutí počítače.

V PowerShellu 7.1 se Stop-Computer přidal pro Linux a macOS. Pro tyto platformy rutina volá nativní příkaz /sbin/shutdown.