Stop-Computer
Leállítja (leállítja) a helyi és a távoli számítógépeket.
Syntax
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Stop-Computer parancsmag leállítja a helyi számítógépet és a távoli számítógépeket.
A Stop-Computer paramétereivel megadhatja a hitelesítési szinteket és a másodlagos hitelesítő adatokat, és azonnali leállítást kényszeríthet.
A PowerShell 7.1-ben Stop-Computer lett hozzáadva Linuxhoz és macOS-hez. A paraméterek nincsenek hatással ezekre a platformokra. A parancsmag csak meghívja a natív parancsot /sbin/shutdown.
Példák
1. példa: A helyi számítógép leállítása
Ez a példa leállítja a helyi számítógépet.
Stop-Computer -ComputerName localhost
2. példa: Két távoli számítógép és a helyi számítógép leállítása
Ez a példa két távoli számítógépet és a helyi számítógépet állítja le.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer a ComputerName paramétert használja két távoli számítógép és a helyi számítógép megadásához. Minden számítógép le van állítva.
3. példa: Távoli számítógépek leállítása háttérfeladatként
Ebben a példában Stop-Computer háttérfeladatként fut két távoli számítógépen.
A háttéroperátor & háttérfeladatként futtatja a Stop-Computer parancsot. További információért lásd: about_Operators.
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer a ComputerName paramétert használja két távoli számítógép megadásához. A & háttér operátor háttérfeladatként futtatja a parancsot. A feladatobjektumok a $j változóban vannak tárolva.
A $j változóban lévő feladatobjektumokat a rendszer elküldi a folyamatnak Receive-Job, amely lekéri a feladat eredményeit. Az objektumok a $results változóban vannak tárolva. A $results változó megjeleníti a feladatadatokat a PowerShell-konzolon.
4. példa: Távoli számítógép leállítása
Ez a példa egy távoli számítógépet állít le megadott hitelesítéssel.
Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos
Stop-Computer a ComputerName paramétert használja a távoli számítógép megadásához. A WsmanAuthentication paraméter azt határozza meg, hogy a Kerberos használatával hozzon létre távoli kapcsolatot.
5. példa: Számítógépek leállítása egy tartományban
Ebben a példában a parancsok egy adott tartomány összes számítógépének azonnali leállítását kényszerítik.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c
Get-Content a Path paraméterrel lekér egy fájlt az aktuális könyvtárban a tartományszámítógépek listájával. Az objektumok a $s változóban vannak tárolva.
Get-Credential a Hitelesítő adatok paraméterrel adja meg a tartományi rendszergazda hitelesítő adatait. A hitelesítő adatokat a $c változó tárolja.
Stop-Computer leállítja a ComputerName paraméter által a $s változóban megadott számítógépek listáját. A Force paraméter azonnali leállítást kényszerít ki. A Hitelesítő adatok paraméter elküldi a $c változóban mentett hitelesítő adatokat.
Paraméterek
-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 PowerShell távoli eléré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
Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.
Megjegyzés:
További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| 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 |
-Force
Kényszeríti a számítógép azonnali leállítását.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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 parancsprogram nem lett futtatva.
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. Az alapértelmezett érték a következő: Alapértelmezett.
A paraméter elfogadható értékei a következők:
- Alapszintű
- CredSSP
- Alapértelmezett
- Összefoglaló
- Kerberos
- Tárgyal.
A paraméter értékeivel kapcsolatos további információkért lásd: AuthenticationMechanism.
Figyelmeztetés
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 PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | Default |
| 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 lehet objektumokat csövezni.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
Ez a parancsmag a következőt használja:
Win32Shutdown
Win32_OperatingSystem WMI-osztály metódusa. Ehhez a módszerhez engedélyezni kell a SeShutdownPrivilege jogosultságot a gép leállításához használt felhasználói fiókhoz.
A PowerShell 7.1-ben Stop-Computer lett hozzáadva Linuxhoz és macOS-hez. Ezeken a platformokon a parancsmag meghívja a natív parancsot /sbin/shutdown.