Share via

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
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-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 leállítási Stop-Computer 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 paramétereket.

Ehhez a parancsmaghoz nincs szükség a PowerShell újraküldésére, kivéve, ha az AsJob paramétert használja.

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.

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

Stop-ComputerA ComputerName paramétert használja két távoli számítógép megadásához. Az AsJob paraméter 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.

Mivel az AsJob létrehozza a feladatot a helyi számítógépen, és automatikusan visszaadja az eredményeket a helyi számítógépnek, helyi parancsként futtatható Receive-Job .

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" -Impersonation Anonymous -DcomAuthentication PacketIntegrity

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 megszemélyesítési paraméter testre szabott megszemélyesítést, a DcomAuthentication paraméter pedig hitelesítési szintű beállításokat ad meg.

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 -ThrottleLimit 10 -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 ThrottleLimit paraméter 10 egyidejű kapcsolatra korlátozza a parancsot. A hitelesítő adat paraméter elküldi a változóban $c mentett hitelesítő adatokat.

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 PowerShellt. További információ: about_Remote_Requirements.

Az AsJob paraméter megadásakor 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 PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.

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

-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

-DcomAuthentication

Megadja a parancsmag által a WMI-vel használt hitelesítési szintet. Stop-Computer WMI-t használ. Az alapértelmezett érték a Csomag.

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

  • Alapértelmezett: Windows-hitelesítés.
  • Nincs: Nincs COM-hitelesítés.
  • Csatlakozás: Csatlakozás szintű COM-hitelesítés.
  • Hívás: Hívásszintű COM-hitelesítés.
  • Csomag: Csomagszintű COM-hitelesítés.
  • PacketIntegrity: Csomagintegritási szintű COM-hitelesítés.
  • PacketPrivacy: Packet Privacy szintű COM-hitelesítés.
  • Változatlan: Ugyanaz, mint az előző parancs.

A paraméter értékeivel kapcsolatos további információkért lásd : 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

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

-Impersonation

Megadja azt a megszemélyesítési szintet, amelyet akkor kell használni, amikor ez a parancsmag meghívja a WMI-t. Az alapértelmezett érték a Megszemélyesítés.

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ás: Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
  • Megszemélyesítés: Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
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

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 PowerShell 3.0-ban vezettük be.

Type:String
Accepted values:DCOM, WSMan
Position:Named
Default value:DCOM
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
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 alapértelmezés szerint nem ad vissza kimenetet.

System.Management.Automation.RemotingJob

Az AsJob paraméter használatakor ez a parancsmag egy RemotingJob objektumot ad vissza.

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.