Stop-Computer
Stopt (sluit) lokale en externe computers.
Syntax
Default (Standaard)
Stop-Computer
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Stop-Computer cmdlet sluit computers op afstand af. Het kan ook de lokale computer afsluiten.
U kunt de parameters van Stop-Computer gebruiken om de afsluitbewerkingen als achtergrondtaak uit te voeren, om de verificatieniveaus en alternatieve referenties op te geven, om de gelijktijdige verbindingen te beperken die worden gemaakt om de opdracht uit te voeren en om een onmiddellijke afsluiting te forceren.
Voor deze cmdlet is geen Windows PowerShell-remotie vereist, tenzij u de parameter AsJob gebruikt.
Voorbeelden
Voorbeeld 1: De lokale computer afsluiten
PS C:\> Stop-Computer
Met deze opdracht wordt de lokale computer afgesloten.
Voorbeeld 2: Twee externe computers en de lokale computer afsluiten
PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Met deze opdracht worden twee externe computers, Server01 en Server02, en de lokale computer, die wordt geïdentificeerd als localhost, gestopt.
Voorbeeld 3: Externe computers afsluiten als achtergrondtaak
PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results
Met deze opdrachten wordt Stop-Computer als achtergrondtaak op twee externe computers uitgevoerd en worden de resultaten opgehaald.
De eerste opdracht geeft de parameter AsJob op om de opdracht als achtergrondtaak uit te voeren. Met de opdracht wordt het resulterende taakobject opgeslagen in de $j variabele.
De tweede opdracht maakt gebruik van een pijplijnoperator om het taakobject in $j naar Receive-Job te verzenden, waarmee de taakresultaten worden opgehaald. Met de opdracht worden de resultaten opgeslagen in de $results variabele.
Met de derde opdracht wordt het resultaat weergegeven dat is opgeslagen in de variabele $results.
Omdat AsJob de taak op de lokale computer maakt en de resultaten automatisch naar de lokale computer retourneert, kunt u Receive-Job uitvoeren als een lokale opdracht.
Voorbeeld 4: Een externe computer afsluiten
PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity
Met deze opdracht wordt de externe computer van Server01 gestopt. De opdracht maakt gebruik van aangepaste imitatie- en verificatie-instellingen.
Voorbeeld 5:
PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
Met deze opdrachten wordt een onmiddellijke afsluiting van alle computers in Domain01 afgedwongen.
Met de eerste opdracht wordt een lijst met computers in het domein opgehaald en worden deze vervolgens opgeslagen in de variabele $s.
Met de tweede opdracht worden de referenties van een domeinbeheerder opgehaald en worden deze vervolgens opgeslagen in de variabele $c.
Met de derde opdracht worden de computers afgesloten. De parameter ComputerName wordt gebruikt om de lijst met computers in de variabele $s in te dienen, de parameter Force om een onmiddellijke afsluiting te forceren en de parameter Credential om de referenties in te dienen die zijn opgeslagen in de variabele $c. Het gebruikt ook de parameter ThrottleLimit om de opdracht te beperken tot 10 gelijktijdige verbindingen.
Parameters
-AsJob
Geeft aan dat deze cmdlet wordt uitgevoerd als achtergrondtaak.
Als u deze parameter wilt gebruiken, moeten de lokale en externe computers zijn geconfigureerd voor extern gebruik en moet u in Windows Vista en latere versies van het Windows-besturingssysteem Windows PowerShell openen met behulp van de optie Uitvoeren als beheerder. Zie about_Remote_Requirements voor meer informatie.
Wanneer u de parameter AsJob opgeeft, retourneert de opdracht onmiddellijk een object dat de achtergrondtaak vertegenwoordigt. U kunt in de sessie blijven werken terwijl de taak is voltooid. De taak wordt gemaakt op de lokale computer en de resultaten van externe computers worden automatisch geretourneerd naar de lokale computer. Gebruik de cmdlet Receive-Job om de taakresultaten op te halen.
Zie about_Jobs en about_Remote_Jobs voor meer informatie over Windows PowerShell-achtergrondtaken.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| 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 |
-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 externe communicatie met Windows PowerShell. U kunt de parameter ComputerName gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.
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, zoals een object uit de cmdlet Get-Credential.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| 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 |
-DcomAuthentication
Hiermee geeft u het verificatieniveau op dat door deze cmdlet wordt gebruikt met WMI. Stop-Computer maakt gebruik van WMI. De acceptabele waarden voor deze parameter zijn:
- Verstek. Windows-verificatie
- Geen. Geen COM-verificatie
- Verbinding maken. COM-verificatie op verbindingsniveau
- Roepen. COM-verificatie op gespreksniveau
- Pakje. COM-verificatie op pakketniveau
- Pakketintegriteit. COM-verificatie op pakketintegriteitsniveau
- Pakket Privacy. COM-verificatie op pakketprivacyniveau
- Ongewijzigd. Hetzelfde als de vorige opdracht
De standaardwaarde is Pakket.
Zie AuthenticationLevel Enumeration in de MSDN-bibliotheek voor meer informatie over de waarden van deze parameter.
Parametereigenschappen
| Type: | AuthenticationLevel |
| Default value: | None |
| Geaccepteerde waarden: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Authenticatie |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Dwingt een onmiddellijke afsluiting van de computers af.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| 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 |
-Impersonation
Hiermee geeft u het imitatieniveau op dat moet worden gebruikt wanneer deze cmdlet WMI aanroept. Stop-Computer maakt gebruik van WMI. De acceptabele waarden voor deze parameter zijn:
- Verstek. Standaardimitatie.
- Anoniem. Verbergt de identiteit van de beller.
- Identificeren. Hiermee kunnen objecten vragen stellen over de inloggegevens van de aanroeper.
- Imiteren. Hiermee kunnen objecten de referenties van de aanroeper gebruiken.
De standaardwaarde is Zich voordoen.
Parametereigenschappen
| Type: | ImpersonationLevel |
| Default value: | None |
| Geaccepteerde waarden: | Default, Anonymous, Identify, Impersonate, Delegate |
| 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 |
-Protocol
Hiermee geeft u op welk protocol moet worden gebruikt om de computers opnieuw op te starten. De acceptabele waarden voor deze parameter zijn: WSMan en DCOM. De standaardwaarde is DCOM.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Geaccepteerde waarden: | DCOM, WSMan |
| 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 |
-ThrottleLimit
Hiermee geeft u het maximum aantal gelijktijdige verbindingen op dat tot stand kan worden gebracht om deze opdracht uit te voeren. Als u deze parameter weglaat of een waarde van 0 invoert, wordt de standaardwaarde 32 gebruikt.
De beperkingslimiet is alleen van toepassing op de huidige opdracht, niet op de sessie of op de computer.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| 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 acceptabele waarden voor deze parameter zijn:
- Eenvoudig
- CredSSP
- Verstek
- Samenvatting
- Kerberos
- Onderhandelen.
De standaardwaarde is Standaard.
Zie Opsomming AuthenticationMechanism in de MSDN-bibliotheek 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 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 Windows PowerShell 3.0.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| 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 invoer voor deze cmdlet niet doorsluisen.
Uitvoerwaarden
None or System.Management.Automation.RemotingJob
De cmdlet retourneert het object System.Management.Automation.RemotingJob als u de parameter AsJob opgeeft. Anders wordt er geen uitvoer gegenereerd.
Notities
- Deze cmdlet maakt gebruik van de methode Win32Shutdown van de WMI-klasse Win32_OperatingSystem.
- In Windows PowerShell 2.0 werkt de parameter AsJob niet betrouwbaar wanneer u externe computers opnieuw opstart/stopt. In Windows PowerShell 3.0 wordt de implementatie gewijzigd om dit probleem op te lossen.