Stop-Computer

  • Referentie
Module:
Microsoft.PowerShell.Management

Stopt (sluit) lokale en externe computers.

Syntax

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

Description

De Stop-Computer cmdlet sluit de lokale computer en externe computers af.

U kunt de parameters gebruiken om Stop-Computer de verificatieniveaus en alternatieve referenties op te geven en een onmiddellijke afsluiting af te dwingen.

In PowerShell 7.1 is Stop-Computer toegevoegd voor Linux en macOS. De parameters hebben geen effect op deze platforms. De cmdlet roept alleen de systeemeigen opdracht /sbin/shutdownaan.

Voorbeelden

Voorbeeld 1: De lokale computer afsluiten

In dit voorbeeld wordt de lokale computer afgesloten.

Stop-Computer -ComputerName localhost

Voorbeeld 2: Twee externe computers en de lokale computer afsluiten

In dit voorbeeld worden twee externe computers en de lokale computer gestopt.

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

Stop-Computer gebruikt de parameter ComputerName om twee externe computers en de lokale computer op te geven. Elke computer wordt afgesloten.

Voorbeeld 3: Externe computers afsluiten als achtergrondtaak

In dit voorbeeld Stop-Computer wordt deze uitgevoerd als achtergrondtaak op twee externe computers.

De achtergrondoperator & voert de Stop-Computer opdracht uit als achtergrondtaak. Zie about_Operators voor meer informatie.

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

Stop-Computer gebruikt de parameter ComputerName om twee externe computers op te geven. De & achtergrondoperator voert de opdracht uit als achtergrondtaak. De taakobjecten worden opgeslagen in de $j variabele.

De taakobjecten in de $j variabele worden naar de pijplijn Receive-Jobverzonden, waarmee de taakresultaten worden opgehaald. De objecten worden opgeslagen in de $results variabele. De $results variabele geeft de taakgegevens weer in de PowerShell-console.

Voorbeeld 4: Een externe computer afsluiten

In dit voorbeeld wordt een externe computer afgesloten met behulp van opgegeven verificatie.

Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos

Stop-Computer gebruikt de parameter ComputerName om de externe computer op te geven. De parameter WsmanAuthentication geeft aan dat Kerberos moet worden gebruikt om een externe verbinding tot stand te brengen.

Voorbeeld 5: Computers in een domein afsluiten

In dit voorbeeld forceren de opdrachten een onmiddellijke afsluiting van alle computers in een opgegeven domein.

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

Get-Content gebruikt de parameter Path om een bestand op te halen in de huidige map met de lijst met domeincomputers. De objecten worden opgeslagen in de $s variabele.

Get-Credential gebruikt de referentieparameter om de referenties van een domeinbeheerder op te geven. De referenties worden opgeslagen in de $c variabele.

Stop-Computersluit de computers die zijn opgegeven met de lijst met computers in de variabele van de $s parameter ComputerName. De parameter Force dwingt een onmiddellijke afsluiting af. De referentieparameter verzendt de referenties die zijn opgeslagen in de $c variabele.

Parameters

-ComputerName

Hiermee geeft u de computers te stoppen. Standaard is dit de lokale computer.

Typ de NETBIOS-naam, het IP-adres of de volledig gekwalificeerde domeinnaam van een of meer computers in een door komma's gescheiden lijst. Als u de lokale computer wilt opgeven, typt u de computernaam of localhost.

Deze parameter is niet afhankelijk van externe communicatie van PowerShell. U kunt de parameter ComputerName zelfs gebruiken als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als SecureString.

Notitie

Zie Hoe veilig is SecureString SecureString?voor meer informatie over SecureString-gegevensbeveiliging.

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

-Force

Dwingt een onmiddellijke afsluiting van de computer af.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

-WsmanAuthentication

Hiermee geeft u het mechanisme op dat wordt gebruikt om de gebruikersreferenties te verifiëren wanneer deze cmdlet het WSMan-protocol gebruikt. De standaardwaarde is Standaard.

De aanvaardbare waarden voor deze parameter zijn:

  • Basis
  • CredSSP
  • Standaardinstelling
  • Digest
  • Kerberos
  • Onderhandelen.

Zie AuthenticationMechanism voor meer informatie over de waarden van deze parameter.

Let op

CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

Deze parameter is geïntroduceerd in PowerShell 3.0.

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

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Deze cmdlet maakt gebruik van de Win32Shutdown methode van de Win32_OperatingSystem WMI-klasse. Voor deze methode moet de SeShutdownPrivilege bevoegdheid zijn ingeschakeld voor het gebruikersaccount dat wordt gebruikt om de computer af te sluiten.

In PowerShell 7.1 is Stop-Computer toegevoegd voor Linux en macOS. Voor deze platforms roept de cmdlet de systeemeigen opdracht /sbin/shutdownaan.