Stop-Computer
Stopt (sluit) lokale en externe computers.
Syntaxis
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Stop-Computer cmdlet sluit de lokale computer en externe computers.
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 niet-Windows-platforms hebben alleen de parameters WhatIf, Confirm en CommonParameters . De cmdlet roept alleen de systeemeigen opdracht aan /sbin/shutdown.
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 wordt Stop-Computer uitgevoerd als achtergrondtaak op twee externe computers.
De achtergrondoperator & voert de Stop-Computer opdracht uit als achtergrondtaak. Zie about_Operatorsvoor 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 variabele $j.
De taakobjecten in de $j variabele worden naar Receive-Jobverzonden naar Receive-Job, waardoor de taakresultaten worden opgehaald. De objecten worden opgeslagen in de variabele $results. 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 variabele $s.
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 sluit de computers die zijn opgegeven met de ComputerName lijst met computers in de variabele $s. De parameter Forceren dwingt een onmiddellijke afsluiting af. De parameter Credential verzendt de referenties die zijn opgeslagen in de variabele $c.
Parameters
-ComputerName
Hiermee geeft u de computers te stoppen. De standaardwaarde is 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 PowerShell-remotegebruik. U kunt de parameter ComputerName gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.
Deze parameter is alleen beschikbaar op Windows-platforms.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | China, __SERVER, Serverapparaat, IPAddress |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Credential
Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is 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.
Opmerking
Zie voor meer informatie over SecureString gegevensbeveiliging Hoe veilig is SecureString?.
Deze parameter is alleen beschikbaar op Windows-platforms.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | Current user |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Dwingt een onmiddellijke afsluiting van de computer af.
Deze parameter is alleen beschikbaar op Windows-platforms.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 Default.
De acceptabele waarden voor deze parameter zijn:
- Eenvoudig
- CredSSP
- Verstek
- Samenvatting
- Kerberos
- Onderhandelen.
Zie AuthenticationMechanismvoor meer informatie over de waarden van deze parameter.
Waarschuwing
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 op afstand uitgevoerde 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. Deze parameter is alleen beschikbaar op Windows-platforms.
Parametereigenschappen
| Type: | String |
| Default value: | Default |
| Geaccepteerde waarden: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
Deze cmdlet maakt gebruik van de methode Win32Shutdown van de WMI-klasse Win32_OperatingSystem. 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 aan /sbin/shutdown.
