Stop-Computer
Lokale en externe computers stoppen (afsluiten).
Syntax
Stop-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met Stop-Computer
de cmdlet worden de lokale en externe computers afgesloten.
U kunt de parameters van Stop-Computer
gebruiken om de verificatieniveaus en alternatieve referenties op te geven en om 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/shutdown
aan.
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 uitgevoerd als een achtergrondtaak op twee externe computers.
De achtergrondoperator &
voert de Stop-Computer
opdracht uit als een 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 een achtergrondtaak. De taakobjecten worden opgeslagen in de $j
variabele.
De taakobjecten in de $j
variabele worden door de pijplijn verzonden naar Receive-Job
, 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 afsluiten in een domein
In dit voorbeeld dwingen de opdrachten een onmiddellijke afsluiting van alle computers in een opgegeven domein af.
$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 parameter Credential om de referenties van een domeinbeheerder op te geven. De referenties worden opgeslagen in de $c
variabele.
Stop-Computer
hiermee worden de computers afgesloten 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 die moeten worden gestopt. Standaard is dit de lokale computer.
Typ de NETBIOS-naam, het IP-adres of de Fully Qualified Domain Name 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 om externe opdrachten uit te voeren.
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 een SecureString.
Notitie
Zie Hoe veilig is 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
Hiermee wordt de computer onmiddellijk afgesloten.
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:
- Basic
- CredSSP
- Standaard
- Samenvatting
- Kerberos
- Onderhandelen.
Zie AuthenticationMechanism voor meer informatie over de waarden van deze parameter.
Waarschuwing
CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer om te 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 gecompromitteerd, kunnen de referenties die aan de externe 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 doorspezen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
Deze cmdlet maakt gebruik van deWin32Shutdown
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/shutdown
aan.