Stop-Computer

  • Referenz
Modul:
Microsoft.PowerShell.Management

Beendet den lokalen Computer und Remotecomputer (fährt sie herunter).

Syntax

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Stop-Computer Cmdlet beendet den lokalen Computer und Remotecomputer.

Sie können die Parameter Stop-Computer verwenden, um die Authentifizierungsstufen und alternativen Anmeldeinformationen anzugeben und ein sofortiges Herunterfahren zu erzwingen.

In PowerShell 7.1 Stop-Computer wurde für Linux und macOS hinzugefügt. Die Parameter haben keine Auswirkungen auf diese Plattformen. Das Cmdlet ruft einfach den systemeigenen Befehl /sbin/shutdownauf.

Beispiele

Beispiel 1: Herunterfahren des lokalen Computers

In diesem Beispiel wird der lokale Computer heruntergefahren.

Stop-Computer -ComputerName localhost

Beispiel 2: Herunterfahren von zwei Remotecomputern und dem lokalen Computer

In diesem Beispiel werden zwei Remotecomputer und der lokale Computer beendet.

Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Stop-Computer verwendet den Parameter ComputerName , um zwei Remotecomputer und den lokalen Computer anzugeben. Jeder Computer wird heruntergefahren.

Beispiel 3: Herunterfahren von Remotecomputern als Hintergrundauftrag

In diesem Beispiel Stop-Computer wird als Hintergrundauftrag auf zwei Remotecomputern ausgeführt.

Der Hintergrundoperator & führt den Stop-Computer Befehl als Hintergrundauftrag aus. Weitere Informationen finden Sie unter about_Operators.

$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results

Stop-Computer verwendet den Parameter ComputerName , um zwei Remotecomputer anzugeben. Der & Hintergrundoperator führt den Befehl als Hintergrundauftrag aus. Die Auftragsobjekte werden in der $j Variablen gespeichert.

Die Auftragsobjekte in der $j Variablen werden an die Pipeline gesendet, an Receive-Jobdie die Auftragsergebnisse zurückgegeben werden. Die Objekte werden in der $results Variablen gespeichert. Die $results Variable zeigt die Auftragsinformationen in der PowerShell-Konsole an.

Beispiel 4: Herunterfahren eines Remotecomputers

In diesem Beispiel wird ein Remotecomputer mithilfe der angegebenen Authentifizierung heruntergefahren.

Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos

Stop-Computer verwendet den Parameter ComputerName , um den Remotecomputer anzugeben. Der WsmanAuthentication-Parameter gibt an, dass Kerberos zum Herstellen einer Remoteverbindung verwendet werden soll.

Beispiel 5: Herunterfahren von Computern in einer Do Standard

In diesem Beispiel erzwingen die Befehle das sofortige Herunterfahren aller Computer in einer angegebenen Do Standard.

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c

Get-Contentverwendet den Parameter "Path", um eine Datei im aktuellen Verzeichnis mit der Liste der do Standard Computer abzurufen. Die Objekte werden in der $s Variablen gespeichert.

Get-Credentialverwendet den Parameter "Credential", um die Anmeldeinformationen eines Do Standard Administrators anzugeben. Die Anmeldeinformationen werden in der $c Variablen gespeichert.

Stop-Computer Beendet die Computer, die mit der Computername-Parameterliste in der $s Variablen angegeben sind. Der Parameter Force erzwingt ein sofortiges Herunterfahren. Der Parameter "Credential " sendet die in der $c Variablen gespeicherten Anmeldeinformationen.

Parameter

-ComputerName

Gibt die Computer an, die beendet werden sollen. Die Standardeinstellung ist der lokale Computer.

Geben Sie den NetBIOS-Namen, die IP-Adresse oder den vollqualifizierten Domänennamen eines Computers oder mehrerer Computer in einer durch Trennzeichen getrennten Liste ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen oder localhost ein.

Dieser Parameter basiert nicht auf PowerShell-Remoting. Sie können den Parameter ComputerName auch dann verwenden, wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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 "Do Standard 01\User01", oder geben Sie ein vom Cmdlet generiertes Get-Credential PSCredential-Objekt ein. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, das Kennwort einzugeben.

Anmeldeinformationen werden in einem PSCredential-Objekt gespeichert, und das Kennwort wird als SecureString gespeichert.

Hinweis

Weitere Informationen zum Schutz von SecureString finden Sie unter "Wie sicher ist SecureString?".

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

-Force

Erzwingt das sofortige Herunterfahren des Computers.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

Gibt den Mechanismus an, der zum Authentifizieren der Benutzeranmeldeinformationen verwendet wird, wenn dieses Cmdlet das WSMan-Protokoll verwendet. Der Standardwert lautet Default.

Zulässige Werte für diesen Parameter:

  • Grundlegend
  • CredSSP
  • Standard
  • Digest
  • Kerberos
  • Verhandeln.

Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism.

Achtung

Credential Security Service Provider (CredSSP)-Authentifizierung, bei der die Benutzeranmeldeinformationen an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle konzipiert, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn die Sicherheit des Remotecomputers gefährdet ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Dieses Cmdlet verwendet das Win32Shutdown -Methode der Win32_OperatingSystem WMI-Klasse. Für diese Methode ist die SeShutdownPrivilege Berechtigung für das Benutzerkonto aktiviert, das zum Herunterfahren des Computers verwendet wird.

In PowerShell 7.1 Stop-Computer wurde für Linux und macOS hinzugefügt. Für diese Plattformen ruft das Cmdlet den systemeigenen Befehl /sbin/shutdownauf.