Sdílet prostřednictvím

Stop-Computer

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntaxe

Stop-Computer
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Stop-Computer vzdáleně vypne počítače. Může také vypnout místní počítač.

Pomocí parametrů zastavit počítač spustit operace vypnutí jako úlohu na pozadí, určit úrovně ověřování a alternativní přihlašovací údaje, omezit souběžná připojení vytvořená ke spuštění příkazu a vynutit okamžité vypnutí.

Tato rutina nevyžaduje vzdálené komunikace Prostředí Windows PowerShell, pokud nepoužíváte parametr AsJob.

Příklady

Příklad 1: Vypnutí místního počítače

PS C:\> Stop-Computer

Tento příkaz vypne místní počítač.

Příklad 2: Vypnutí dvou vzdálených počítačů a místního počítače

PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Tento příkaz zastaví dva vzdálené počítače, Server01 a Server02 a místní počítač identifikovaný jako localhost.

Příklad 3: Vypnutí vzdálených počítačů jako úlohy na pozadí

PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results

Tyto příkazy spustí zastavit počítač jako úlohu na pozadí na dvou vzdálených počítačích a pak získají výsledky.

První příkaz určuje parametr AsJob ke spuštění příkazu jako úlohu na pozadí. Příkaz uloží výsledný objekt úlohy do proměnné $j.

Druhý příkaz používá operátor kanálu k odeslání objektu úlohy v $j do receive-job, který získá výsledky úlohy. Příkaz uloží výsledky do proměnné $results.

Třetí příkaz zobrazí výsledek uložený v proměnné $results.

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 úloha příjmu jako místní příkaz.

Příklad 4: Vypnutí vzdáleného počítače

PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity

Tento příkaz zastaví vzdálený počítač Serveru01. Příkaz používá vlastní nastavení zosobnění a ověřování.

Příklad 5:

PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c

Tyto příkazy vynutí okamžité vypnutí všech počítačů v doméně Domain01.

První příkaz získá seznam počítačů v doméně a pak je uloží do proměnné $s.

Druhý příkaz získá přihlašovací údaje správce domény a pak je uloží do proměnné $c.

Třetí příkaz vypne počítače. Pomocí parametru ComputerName odešle seznam počítačů v proměnné $s, parametr Vynucení vynucení okamžitého vypnutí a parametr přihlašovacích údajů k odeslání přihlašovacích údajů uložených v proměnné $c. Používá také parametr ThrottleLimit k omezení příkazu na 10 souběžných připojení.

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 Prostředí Windows PowerShell pomocí možnosti Spustit jako správce. Další informace najdete 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 prostředí Windows PowerShell na pozadí najdete v tématu about_Jobs a about_Remote_Jobs.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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álené komunikace Windows PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný pro spouštění vzdálených příkazů.

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, například objekt z rutiny Get-Credential.

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

-DcomAuthentication

Určuje úroveň ověřování, kterou tato rutina používá s rozhraním WMI. stop-computer používá rozhraní WMI. Přijatelné hodnoty pro tento parametr jsou:

  • Výchozí. Ověřování systému Windows
  • Žádný. Bez ověřování modelu COM
  • Spojit. Ověřování modelu COM na úrovni připojení
  • Zavolat. Ověřování modelu COM na úrovni volání
  • Balíček. 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ů
  • Nezměněný. Stejné jako předchozí příkaz

Výchozí hodnota je Packet.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationLevel Výčet v knihovně MSDN.

Typ:AuthenticationLevel
Aliasy:Authentication
Přípustné hodnoty:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

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

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

-Impersonation

Určuje úroveň zosobnění, která se má použít, když tato rutina volá rozhraní WMI. 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.
  • Zosobňovat. Umožňuje objektům používat přihlašovací údaje volajícího.

Výchozí hodnota je Zosobnění.

Typ:ImpersonationLevel
Přípustné hodnoty:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 DCOM.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:String
Přípustné hodnoty:DCOM, WSMan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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č.

Typ:Int32
Position:Named
Default value:None
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. Přijatelné hodnoty pro tento parametr jsou:

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

Výchozí hodnota je Default.

Další informace o hodnotách tohoto parametru najdete v tématu AuthenticationMechanism – výčet v knihovně MSDN.

Upozornění: 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, 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 k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Tento parametr byl představen ve Windows PowerShellu 3.0.

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

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

None or System.Management.Automation.RemotingJob

Rutina vrátí objekt System.Management.Automation.RemotingJob, pokud zadáte parametr AsJob. Jinak nevygeneruje žádný výstup.

Poznámky

  • Tato rutina používá metodu Win32Shutdown třídy Win32_OperatingSystem WMI.
  • V prostředí Windows PowerShell 2.0 nefunguje parametr AsJob spolehlivě při restartování nebo zastavování vzdálených počítačů. V prostředí Windows PowerShell 3.0 se implementace změní, aby se tento problém vyřešil.