Stop-Computer
Leállítja (leállítja) a helyi és a távoli számítógépeket.
Syntax
Default (Alapértelmezett)
Stop-Computer
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Stop-Computer parancsmag távolról leállítja a számítógépeket. A helyi számítógépet is leállítja.
A leállítási műveletek háttérfeladatként való futtatásához, a hitelesítési szintek és a másodlagos hitelesítő adatok megadásához, a parancs futtatásához létrehozott egyidejű kapcsolatok korlátozásához és az azonnali leállítás kényszerítéséhez használhatja a leállítási paramétereit.
Ez a parancsmag csak akkor igényli a Windows PowerShell újraküldését, ha a AsJob paramétert használja.
Példák
1. példa: A helyi számítógép leállítása
PS C:\> Stop-Computer
Ez a parancs leállítja a helyi számítógépet.
2. példa: Két távoli számítógép és a helyi számítógép leállítása
PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Ez a parancs leállítja a helyi állomásként azonosított két távoli számítógépet, a Server01-et és a Server02-t, valamint a helyi számítógépet.
3. példa: Távoli számítógépek leállítása háttérfeladatként
PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results
Ezek a parancsok két távoli számítógépen futtatják a Számítógép leállítása háttérfeladatként, majd lekérik az eredményeket.
Az első parancs a AsJob paramétert adja meg a parancs háttérfeladatként való futtatásához. A parancs menti az eredményként kapott feladatobjektumot a $j változóba.
A második parancs egy folyamatkezelővel küldi el a feladatobjektumot a $j Fogadófeladat, amely lekéri a feladat eredményeit. A parancs menti az eredményeket a $results változóba.
A harmadik parancs megjeleníti a $results változóban mentett eredményt.
Mivel AsJob létrehozza a feladatot a helyi számítógépen, és automatikusan visszaadja az eredményeket a helyi számítógépre, helyi parancsként futtathatja Fogadófeladat.
4. példa: Távoli számítógép leállítása
PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity
Ez a parancs leállítja a Server01 távoli számítógépet. A parancs testre szabott megszemélyesítési és hitelesítési beállításokat használ.
5. példa:
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
Ezek a parancsok a Tartomány01 összes számítógépének azonnali leállítását kényszerítik.
Az első parancs lekéri a tartomány számítógépeinek listáját, majd a $s változóban tárolja őket.
A második parancs lekéri egy tartományi rendszergazda hitelesítő adatait, majd a $c változóban tárolja őket.
A harmadik parancs leállítja a számítógépeket. A ComputerName paraméter használatával küldi el a $s változóban lévő számítógépek listáját, a Kényszerített paramétert az azonnali leállítás kényszerítéséhez, a Hitelesítő adatok paramétert pedig a $c változóban mentett hitelesítő adatok elküldéséhez. A ThrottleLimit paramétert is használja a parancs 10 egyidejű kapcsolatra való korlátozásához.
Paraméterek
-AsJob
Azt jelzi, hogy ez a parancsmag háttérfeladatként fut.
A paraméter használatához a helyi és a távoli számítógépeket újra kell konfigurálni, a Windows Vista és a Windows operációs rendszer újabb verzióiban pedig a Futtatás rendszergazdaként lehetőséggel kell megnyitnia a Windows PowerShellt. További információ: about_Remote_Requirements.
Amikor megadja a AsJob paramétert, a parancs azonnal visszaad egy objektumot, amely a háttérfeladatot jelöli. Folytathatja a munkát a munkamenetben, amíg a feladat befejeződik. A feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.
További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ComputerName
Megadja a leállítandó számítógépeket. Az alapértelmezett beállítás a helyi számítógép.
Írja be egy vagy több számítógép NETBIOS-nevét, IP-címét vagy teljes tartománynevét egy vesszővel tagolt listában. A helyi számítógép megadásához írja be a számítógép nevét vagy a localhost nevet.
Ez a paraméter nem támaszkodik a Windows PowerShell-újraegyezésre. A ComputerName paramétert akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Kína, __KISZOLGÁLÓ, Szerver, IP cím |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például egyet a Get-Credential parancsmagból.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DcomAuthentication
Megadja a parancsmag által a WMI-vel használt hitelesítési szintet. Stop-Computer WMI-t használ. A paraméter elfogadható értékei a következők:
- Alapértelmezett. Windows-hitelesítés
- Nincs. Nincs COM-hitelesítés
- Csatlakozzon. Kapcsolódási szintű COM-hitelesítés
- Hív. Hívásszintű COM-hitelesítés
- Csomag. Csomagszintű COM-hitelesítés
- Csomagintegritás. Csomagintegritási szintű COM-hitelesítés
- CsomagPrivacy. Csomag adatvédelmi szintű COM-hitelesítése
- Változatlan. Ugyanaz, mint az előző parancs
Az alapértelmezett érték a Csomag.
A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationLevel Enumeration az MSDN-kódtárban.
Paramétertulajdonságok
| Típus: | AuthenticationLevel |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Hitelesítés |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Kényszeríti a számítógépek azonnali leállítását.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Impersonation
Megadja azt a megszemélyesítési szintet, amelyet akkor kell használni, amikor ez a parancsmag meghívja a WMI-t. Stop-Computer WMI-t használ. A paraméter elfogadható értékei a következők:
- Alapértelmezett. Alapértelmezett megszemélyesítés.
- Névtelen. Elrejti a hívó identitását.
- Azonosít. Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
- Megszemélyesíteni. Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
Az alapértelmezett érték a Megszemélyesítés.
Paramétertulajdonságok
| Típus: | ImpersonationLevel |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, Anonymous, Identify, Impersonate, Delegate |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Protocol
Megadja, hogy melyik protokollt kell használni a számítógépek újraindításához. A paraméter elfogadható értékei a következők: WSMan és DCOM. Az alapértelmezett érték a DCOM.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | DCOM, WSMan |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát. Ha kihagyja ezt a paramétert, vagy 0 értéket ad meg, a rendszer az alapértelmezett 32 értéket használja.
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WsmanAuthentication
Megadja azt a mechanizmust, amely a felhasználói hitelesítő adatok hitelesítésére szolgál, amikor ez a parancsmag a WSMan protokollt használja. A paraméter elfogadható értékei a következők:
- Alapszintű
- CredSSP
- Alapértelmezett
- Összefoglaló
- Kerberos
- Tárgyal.
Az alapértelmezett érték az Alapértelmezett.
A paraméter értékeivel kapcsolatos további információkért tekintse meg AuthenticationMechanism Enumeration az MSDN-kódtárban.
Figyelem: A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
None or System.Management.Automation.RemotingJob
A parancsmag egy System.Management.Automation.RemotingJob objektumot ad vissza, ha megadja az AsJob paramétert. Ellenkező esetben nem hoz létre kimenetet.
Jegyzetek
- Ez a parancsmag a Win32_OperatingSystem WMI-osztály Win32Shutdown metódusát használja.
- A Windows PowerShell 2.0-ban az AsJob paraméter nem működik megbízhatóan távoli számítógépek újraindításakor/leállításakor. A Windows PowerShell 3.0-ban az implementáció módosul a probléma megoldásához.