Beendet lokale und Remotecomputer (fährt sie herunter).
Syntax
Stop-Computer [[-ComputerName] <string[]>] [[-Credential] <PSCredential>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Force] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-ThrottleLimit <int>] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Stop-Computer" fährt Computer remote herunter. Es kann auch den lokalen Computer herunterfahren.
Sie können mit den Parametern von Stop-Computer Vorgänge zum Herunterfahren als Hintergrundauftrag ausführen, die Authentifizierungsebenen und alternative Anmeldeinformationen angeben, die gleichzeitigen Verbindungen einschränken, die zum Ausführen des Befehls erstellt werden, und ein sofortiges Herunterfahren erzwingen.
Für dieses Cmdlet sind keine Windows PowerShell-Remotingfunktionen erforderlich, es sei denn, Sie verwenden den AsJob-Parameter.
Parameter
-AsJob
Führt den Befehl als Hintergrundauftrag aus.
Hinweis: Um diesen Parameter zu verwenden, müssen die lokalen Computer und Remotecomputer für Remoting konfiguriert sein, und Sie müssen Windows PowerShell unter Windows Vista und höheren Versionen von Windows mit der Option "Als Administrator ausführen" öffnen. Weitere Informationen finden Sie unter "about_Remote_Requirements".
Wenn Sie den AsJob-Parameter verwenden, gibt der Befehl sofort ein Objekt zurück, das den Hintergrundauftrag darstellt. Sie können die Sitzung weiterhin verwenden, während der Auftrag abgeschlossen wird. Der Auftrag wird auf dem lokalen Computer erstellt, und die Ergebnisse von Remotecomputern werden automatisch an den lokalen Computer zurückgegeben. Um den Auftrag zu verwalten, verwenden Sie die Job-Cmdlets. Um die Auftragsergebnisse abzurufen, verwenden Sie das Cmdlet "Receive-Job".
Weitere Informationen über Windows PowerShell-Hintergrundaufträge finden Sie unter "about_Jobs" und "about_Remote_Jobs".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Authentication <AuthenticationLevel>
Gibt die Authentifizierungsebene an, die für die WMI-Verbindung verwendet wird. (Stop-Computer verwendet WMI.) Der Standardwert ist "Packet".
Gültige Werte:
Unchanged: Die Authentifizierungsebene entspricht dem vorherigen Befehl.
Default: Windows-Authentifizierung.
None: Keine COM-Authentifizierung.
Connect: COM-Authentifizierung auf Verbindungsebene.
Call: COM-Authentifizierung auf Aufrufebene.
Packet: COM-Authentifizierung auf Paketebene.
PacketIntegrity: COM-Authentifizierung auf Paketintegritätsebene.
PacketPrivacy: COM-Authentifizierung auf Paketsicherheitsebene.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
4 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ComputerName <string[]>
Beendet die angegebenen Computer. Der Standardwert ist der lokale Computer.
Geben Sie den NETBIOS-Namen, die IP-Adresse oder den vollqualifizierten Domänennamen eines oder mehrerer Computer in einer durch Trennzeichen getrennten Liste ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen oder "localhost" ein.
Dieser Parameter beruht nicht auf Windows PowerShell-Remoting. Sie können den ComputerName-Parameter auch dann verwenden, wenn der Computer nicht für das Ausführen von Remotebefehlen konfiguriert ist.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
. |
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Credential <PSCredential>
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt aus dem Cmdlet "Get-Credential".
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
Current user |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Erzwingt ein unmittelbares Herunterfahren der Computer.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
False |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Impersonation <ImpersonationLevel>
Gibt die Identitätswechselebene an, die beim Aufrufen von WMI verwendet werden soll. (Stop-Computer verwendet WMI.) Der Standardwert ist "Impersonate".
Gültige Werte:
Default: Standardidentitätswechsel.
Anonymous: Blendet die Identität des Aufrufers aus.
Identify: Ermöglicht es Objekten, die Anmeldeinformationen des Aufrufers abzufragen.
Impersonate: Ermöglicht es Objekten, die Anmeldeinformationen des Aufrufers zu verwenden.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
Impersonate |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ThrottleLimit <int>
Gibt die maximale Anzahl von gleichzeitigen Verbindungen an, die zum Ausführen dieses Befehls hergestellt werden können. Wenn Sie diesen Parameter weglassen oder den Wert 0 eingeben, wird der Standardwert 32 verwendet.
Die Drosselungsgrenze gilt nur für den aktuellen Befehl und nicht für die Sitzung oder den Computer.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
32 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
|
Ausgaben |
Keiner oder System.Management.Automation.RemotingJob Wenn Sie den AsJob-Parameter verwenden, gibt das Cmdlet ein Auftragsobjekt zurück (System.Management.Automation.RemotingJob). Andernfalls wird keine Ausgabe generiert. |
Hinweise
Dieses Cmdlet verwendet die Win32Shutdown-Methode der Win32_OperatingSystem-WMI-Klasse.
Beispiel 1
C:\PS>stop-computer Beschreibung ----------- Dieser Befehl fährt den lokalen Computer herunter.
Beispiel 2
C:\PS>stop-computer -computername Server01, Server02, localhost Beschreibung ----------- Dieser Befehl beendet zwei Remotecomputer "Server01" und "Server02" sowie den lokalen Computer, der als "localhost" identifiziert wurde.
Beispiel 3
C:\PS>$j = stop-computer -computername Server01, Server02 -asjob C:\PS> $results = $j | receive-job C:\PS> $results Beschreibung ----------- Diese Befehle führen den Befehl "Stop-Computer" als Hintergrundauftrag auf zwei Remotecomputern aus und rufen dann die Ergebnisse ab. Beim ersten Befehl wird der Befehl mithilfe des AsJob-Parameters als Hintergrundauftrag ausgeführt. Mit dem Befehl wird das resultierende Auftragsobjekt in der Variablen "$j" gespeichert. Der zweite Befehl sendet das Auftragsobjekt in "$j" mithilfe eines Pipelineoperators an das Cmdlet "Receive-Job", das die Auftragsergebnisse abruft. Anschließend werden die Ergebnisse in der Variablen "$results" gespeichert. Der dritte Befehl zeigt das in der Variablen "$results" gespeicherte Ergebnis an. Da der AsJob-Parameter den Auftrag auf dem lokalen Computer erstellt und die Ergebnisse automatisch an den lokalen Computer zurückgibt, können Sie den Befehl "Receive-Job" als lokalen Befehl ausführen.
Beispiel 4
C:\PS>stop-computer -comp Server01 -impersonation anonymous -authentication PacketIntegrity Beschreibung ----------- Dieser Befehl startet den Remotecomputer "Server01" neu. Der Befehl verwendet benutzerdefinierte Einstellungen für Identitätswechsel und Authentifizierung.
Beispiel 5
C:\PS>$s = get-content domain01.txt C:\PS> $c = get-credential domain01\admin01 C:\PS> stop-computer -computername $s -force -throttlelimit 10 -credential $c Beschreibung ----------- Diese Befehle erzwingen das sofortige Herunterfahren aller Computer in "Domain01". Der erste Befehl ruft eine Liste von Computern in der Domäne ab und speichert sie in der Variablen "$s". Der zweite Befehl ruft die Anmeldeinformationen eines Domänenadministrators ab und speichert sie in der Variablen "$c". Der dritte Befehl fährt die Computer herunter. Mit dem ComputerName-Parameter wird die Liste der Computer in der Variablen "$s" gesendet, mit dem Force-Parameter wird ein sofortiges Herunterfahren erzwungen, und mit dem Credential-Parameter werden die in der Variablen "$c" gespeicherten Anmeldeinformationen gesendet. Außerdem wird der Befehl mithilfe des ThrottleLimit-Parameters auf 10 gleichzeitige Verbindungen eingeschränkt.
Siehe auch