Stop-Computer
Stoppar (stänger av) lokala datorer och fjärrdatorer.
Syntax
Stop-Computer
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Stop-Computer
stänger av den lokala datorn och fjärrdatorerna.
Du kan använda parametrarna Stop-Computer
för för att köra avstängningsåtgärderna som ett bakgrundsjobb, för att ange autentiseringsnivåer och alternativa autentiseringsuppgifter, för att begränsa de samtidiga anslutningar som skapas för att köra kommandot och för att tvinga fram en omedelbar avstängning.
Den här cmdleten kräver inte PowerShell-fjärrkommunikation om du inte använder asjob-parametern .
Exempel
Exempel 1: Stäng av den lokala datorn
Det här exemplet stänger av den lokala datorn.
Stop-Computer -ComputerName localhost
Exempel 2: Stäng av två fjärrdatorer och den lokala datorn
Det här exemplet stoppar två fjärrdatorer och den lokala datorn.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer
använder parametern ComputerName för att ange två fjärrdatorer och den lokala datorn. Varje dator stängs av.
Exempel 3: Stäng av fjärrdatorer som ett bakgrundsjobb
I det här exemplet Stop-Computer
körs som ett bakgrundsjobb på två fjärrdatorer.
$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results
Stop-Computer
använder parametern ComputerName för att ange två fjärrdatorer. Parametern AsJob kör kommandot som ett bakgrundsjobb. Jobbobjekten lagras i variabeln $j
.
Jobbobjekten i variabeln $j
skickas ned i pipelinen till Receive-Job
, som hämtar jobbresultatet. Objekten lagras i variabeln $results
. Variabeln $results
visar jobbinformationen i PowerShell-konsolen.
Eftersom AsJob skapar jobbet på den lokala datorn och automatiskt returnerar resultatet till den lokala datorn kan du köra Receive-Job
som ett lokalt kommando.
Exempel 4: Stäng av en fjärrdator
Det här exemplet stänger av en fjärrdator med angiven autentisering.
Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Stop-Computer
använder parametern ComputerName för att ange fjärrdatorn. Parametern Personifiering anger en anpassad personifiering och parametern DcomAuthentication anger inställningar på autentiseringsnivå.
Exempel 5: Stänga av datorer i en domän
I det här exemplet tvingar kommandona en omedelbar avstängning av alla datorer i en angiven domän.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
Get-Content
använder parametern Sökväg för att hämta en fil i den aktuella katalogen med listan över domändatorer. Objekten lagras i variabeln $s
.
Get-Credential
använder parametern Credential för att ange autentiseringsuppgifterna för en domänadministratör. Autentiseringsuppgifterna lagras i variabeln $c
.
Stop-Computer
stänger av de datorer som anges med parametern ComputerNames lista över datorer i variabeln $s
. Force-parametern tvingar fram en omedelbar avstängning. Parametern ThrottleLimit begränsar kommandot till 10 samtidiga anslutningar. Parametern Credential skickar de autentiseringsuppgifter som sparats i variabeln $c
.
Parametrar
-AsJob
Anger att den här cmdleten körs som ett bakgrundsjobb.
Om du vill använda den här parametern måste de lokala och fjärranslutna datorerna konfigureras för fjärrkommunikation och i Windows Vista och senare versioner av Windows-operativsystemet måste du öppna PowerShell med alternativet Kör som administratör . Mer information finns i about_Remote_Requirements.
När du anger parametern AsJob returnerar kommandot omedelbart ett objekt som representerar bakgrundsjobbet. Du kan fortsätta att arbeta i sessionen medan jobbet är klart. Jobbet skapas på den lokala datorn och resultatet från fjärrdatorerna returneras automatiskt till den lokala datorn. Använd cmdleten för att hämta jobbresultatet Receive-Job
.
Mer information om PowerShell-bakgrundsjobb finns i about_Jobs och about_Remote_Jobs.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Anger vilka datorer som ska stoppas. Standard är den lokala datorn.
Ange NETBIOS-namn, IP-adress eller fullständigt domännamn för en eller flera datorer i en kommaavgränsad lista. Om du vill ange den lokala datorn skriver du datornamnet eller localhost.
Den här parametern förlitar sig inte på PowerShell-fjärrkommunikation. Du kan använda parametern ComputerName även om datorn inte är konfigurerad för att köra fjärrkommandon.
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren.
Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt som genereras av cmdleten Get-Credential
. Om du skriver ett användarnamn uppmanas du att ange lösenordet.
Autentiseringsuppgifter lagras i ett PSCredential-objekt och lösenordet lagras som en SecureString.
Kommentar
Mer information om SecureString-dataskydd finns i Hur säker är SecureString?.
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DcomAuthentication
Anger den autentiseringsnivå som den här cmdleten använder med WMI. Stop-Computer
använder WMI. Standardvärdet är Paket.
De acceptabla värdena för den här parametern är:
- Standard: Windows-autentisering.
- Ingen: Ingen COM-autentisering.
- Anslut: COM-autentisering på Anslut nivå.
- Samtal: COM-autentisering på samtalsnivå.
- Paket: COM-autentisering på paketnivå.
- PacketIntegrity: COM-autentisering på paketintegritetsnivå.
- PacketPrivacy: COM-autentisering på paketsekretessnivå.
- Oförändrad: Samma som föregående kommando.
Mer information om värdena för den här parametern finns i AuthenticationLevel.
Type: | AuthenticationLevel |
Aliases: | Authentication |
Accepted values: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
Default value: | Packet |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Tvingar fram en omedelbar avstängning av datorn.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Impersonation
Anger den personifieringsnivå som ska användas när den här cmdleten anropar WMI. Standardvärdet är Personifiera.
Stop-Computer
använder WMI. De acceptabla värdena för den här parametern är:
- Standard: Standardpersonifiering.
- Anonym: Döljer uppringarens identitet.
- Identifiera: Tillåter objekt att köra frågor mot anroparens autentiseringsuppgifter.
- Personifiera: Tillåter att objekt använder anroparens autentiseringsuppgifter.
Type: | ImpersonationLevel |
Accepted values: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | Impersonate |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Anger vilket protokoll som ska användas för att starta om datorerna. De godtagbara värdena för den här parametern är: WSMan och DCOM. Standardvärdet är DCOM.
Den här parametern introducerades i PowerShell 3.0.
Type: | String |
Accepted values: | DCOM, WSMan |
Position: | Named |
Default value: | DCOM |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
Anger det maximala antalet samtidiga anslutningar som kan upprättas för att köra det här kommandot. Om du utelämnar den här parametern eller anger värdet 0 används standardvärdet 32.
Begränsningsgränsen gäller endast för det aktuella kommandot, inte för sessionen eller på datorn.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
Anger den mekanism som används för att autentisera användarautentiseringsuppgifterna när den här cmdleten använder WSMan-protokollet. Standardvärdet är Standard.
De acceptabla värdena för den här parametern är:
- Grundläggande
- CredSSP
- Standardvärde
- Digest
- Kerberos
- Förhandla.
Mer information om värdena för den här parametern finns i AuthenticationMechanism.
Varning
CredSSP-autentisering (CredSSP), där användarautentiseringsuppgifterna skickas till en fjärrdator som ska autentiseras, är utformad för kommandon som kräver autentisering på mer än en resurs, till exempel åtkomst till en fjärrnätverksresurs. Den här mekanismen ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan de autentiseringsuppgifter som skickas till den användas för att styra nätverkssessionen.
Den här parametern introducerades i 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 |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
None
Som standard returnerar den här cmdleten inga utdata.
System.Management.Automation.RemotingJob
När du använder parametern AsJob returnerar den här cmdleten ett RemotingJob-objekt .
Kommentarer
Den här cmdleten använder Win32Shutdown
metoden för WMI-klassen Win32_OperatingSystem
. Den här metoden kräver att behörigheten SeShutdownPrivilege
aktiveras för det användarkonto som används för att stänga av datorn.
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för