Stop-Computer

  • Referencia
Modul:
Microsoft.PowerShell.Management

Leállítja (leállítja) a helyi és a távoli számítógépeket.

Syntax

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-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 paraméterekkel Stop-Computer megadhatja a hitelesítési szinteket és a másodlagos hitelesítő adatokat, és kényszerítheti az azonnali leállítást.

A PowerShell 7.1-ben Stop-Computer Linuxhoz és macOS-hez lett hozzáadva. A paraméterek nincsenek hatással ezekre a platformokra. A parancsmag csak a natív parancsot /sbin/shutdownhívja meg.

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-ComputerA 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ér operátor & háttérfeladatként futtatja a Stop-Computer parancsot. További információ: about_Operators.

$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results

Stop-ComputerA 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 változóban lévő feladatobjektumokat a $j rendszer elküldi a folyamatnak Receive-Job, amely lekéri a feladat eredményeit. Az objektumok a változóban $results 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 Számítógépnév paraméter használatával adja meg a távoli számítógépet. 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-ContentA Path paraméterrel lekér egy fájlt az aktuális könyvtárban a tartományi számítógépek listájával. Az objektumok a változóban $s vannak tárolva.

Get-CredentialA 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-Computerleállítja a ComputerName paraméter számítógéplistájában megadott számítógépeket a $s változóban. A Force paraméter azonnali leállítást kényszerít ki. A hitelesítő adat paraméter elküldi a változóban $c mentett hitelesítő adatokat.

Paraméterek

-ComputerName

Megadja a leállítandó számítógépeket. Alapértelmezés szerint 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-újraegyezésre. Akkor is használhatja a ComputerName paramétert, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Alapértelmezés szerint az aktuális felhasználó.

Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.

Feljegyzés

További információ a SecureString adatvédelemről: Mennyire biztonságos a SecureString?.

Type:PSCredential
Position:1
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Kényszeríti a számítógép azonnali leállítását.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 az Alapértelmezett érték.

A paraméter elfogadható értékei a következők:

  • Alap
  • CredSSP
  • Alapértelmezett
  • Digest
  • Kerberos
  • Tárgyalni.

A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism.

Figyelemfelhívá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.

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

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 a WMI-osztály metódusát Win32_OperatingSystem . Ehhez a metódushoz 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 Linuxhoz és macOS-hez lett hozzáadva. Ezeken a platformokon a parancsmag meghívja a natív parancsot /sbin/shutdown.