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í 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 vynucení okamžitého vypnutí.

V PowerShellu 7.1 Stop-Computer byl přidán 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 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 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 pomocí parametru Cesta získá soubor 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ženy v $c proměnné.

Stop-Computer vypne počítače zadané seznamem parametrů 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ý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 se nespoléhá na vzdálené komunikace PowerShellu. Parametr ComputerName můžete použít i v případě, že počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
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
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 naleznete v tématu Jak zabezpečený je SecureString?.

Type:PSCredential
Position:1
Default value:Current user
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value: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
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
  • Výchozí
  • Trávit
  • Kerberos
  • Vyjednávat.

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

Upozornění

Ověřování poskytovatele služeb zabezpečení přihlašovacích údajů (CredSSP), 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ěřování 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 přihlašovací údaje předávané do ní použít k řízení síťové relace.

Tento parametr byl zaveden v PowerShellu 3.0.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:Default
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Vstup do této rutiny nejde zadat.

Výstupy

None

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 restartování počítače.

V PowerShellu 7.1 Stop-Computer byl přidán pro Linux a macOS. Pro tyto platormy rutina volá nativní příkaz /sbin/shutdown.