다음을 통해 공유

Stop-Computer

  • 참조
모듈:
Microsoft.PowerShell.Management

로컬 및 원격 컴퓨터를 중지(종료)합니다.

구문

Stop-Computer
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet은 Stop-Computer 로컬 컴퓨터와 원격 컴퓨터를 종료합니다.

종료 작업을 백그라운드 작업으로 실행하고, 인증 수준 및 대체 자격 증명을 지정하고, 명령을 실행하기 위해 생성된 동시 연결을 제한하고, 즉시 종료를 강제하는 매개 변수 Stop-Computer 를 사용할 수 있습니다.

이 cmdlet은 AsJob 매개 변수를 사용하지 않는 한 PowerShell 원격이 필요하지 않습니다.

예제

예제 1: 로컬 컴퓨터 종료

다음은 로컬 컴퓨터를 종료하는 예제입니다.

Stop-Computer -ComputerName localhost

예제 2: 두 개의 원격 컴퓨터와 로컬 컴퓨터 종료

이 예제에서는 두 개의 원격 컴퓨터와 로컬 컴퓨터를 중지합니다.

Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Stop-Computer 는 ComputerName 매개 변수를 사용하여 두 개의 원격 컴퓨터와 로컬 컴퓨터를 지정합니다. 각 컴퓨터가 종료됩니다.

예제 3: 백그라운드 작업으로 원격 컴퓨터 종료

이 예제에서는 Stop-Computer 두 원격 컴퓨터에서 백그라운드 작업으로 실행됩니다.

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

Stop-Computer 는 ComputerName 매개 변수를 사용하여 두 개의 원격 컴퓨터를 지정합니다. AsJob 매개 변수는 명령을 백그라운드 작업으로 실행합니다. 작업 개체는 변수에 $j 저장됩니다.

변수의 $j 작업 개체는 파이프라인 Receive-Job아래로 전송되어 작업 결과를 가져옵니다. 개체는 변수에 $results 저장됩니다. 이 변수는 $results PowerShell 콘솔에 작업 정보를 표시합니다.

AsJob은 로컬 컴퓨터에서 작업을 만들고 결과를 로컬 컴퓨터에 자동으로 반환하므로 로컬 명령으로 실행할 Receive-Job 수 있습니다.

예제 4: 원격 컴퓨터 종료

다음은 지정된 인증을 사용하여 원격 컴퓨터를 종료하는 예제입니다.

Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity

Stop-Computer 는 ComputerName 매개 변수를 사용하여 원격 컴퓨터를 지정합니다. Impersonation 매개 변수는 사용자 지정된 가장을 지정하고 DcomAuthentication 매개 변수는 인증 수준 설정을 지정합니다.

예제 5: 도메인에서 컴퓨터 종료

이 예제에서 명령은 지정된 도메인에 있는 모든 컴퓨터를 즉시 종료합니다.

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c

Get-Content 에서는 Path 매개 변수를 사용하여 도메인 컴퓨터 목록을 사용하여 현재 디렉터리에 파일을 가져옵니다. 개체는 변수에 $s 저장됩니다.

Get-Credential 는 자격 증명 매개 변수를 사용하여 도메인 관리자의 자격 증명을 지정합니다. 자격 증명은 변수에 $c 저장됩니다.

Stop-Computer는 변수에 있는 ComputerName 매개 변수의 컴퓨터 목록으로 지정된 컴퓨터를 종료합니다$s. Force 매개 변수를 강제로 즉시 종료합니다. ThrottleLimit 매개 변수는 명령을 10개의 동시 연결로 제한합니다. 자격 증명 매개 변수는 변수에 저장된 자격 증명을 $c 제출합니다.

매개 변수

-AsJob

이 cmdlet이 백그라운드 작업으로 실행됨을 나타냅니다.

이 매개 변수를 사용하려면 원격으로 로컬 및 원격 컴퓨터를 구성해야 하며 Windows Vista 이상 버전의 Windows 운영 체제에서는 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 열어야 합니다. 자세한 내용은 about_Remote_Requirements 참조하세요.

AsJob 매개 변수를 지정하면 이 명령은 백그라운드 작업을 나타내는 개체를 즉시 반환합니다. 작업이 완료되는 동안 세션에서 작업을 계속할 수 있습니다. 작업이 로컬 컴퓨터에 만들어지고 원격 컴퓨터의 결과가 자동으로 로컬 컴퓨터로 반환됩니다. 작업 결과를 얻으려면 cmdlet을 Receive-Job 사용합니다.

PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs 참조하세요.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ComputerName

중지할 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.

쉼표로 구분된 목록에 하나 이상의 컴퓨터의 NETBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 또는 localhost를 입력합니다.

이 매개 변수는 PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수를 사용할 수 있습니다.

형식:String[]
별칭:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

User01 또는 Domain01\User01과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

자격 증명은 PSCredential 개체에 저장되고 암호는 SecureString으로 저장됩니다.

참고 항목

SecureString 데이터 보호에 대한 자세한 내용은 SecureString이 얼마나 안전한가요?를 참조하세요.

형식:PSCredential
Position:1
Default value:Current user
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DcomAuthentication

이 cmdlet이 WMI와 함께 사용하는 인증 수준을 지정합니다. Stop-Computer 는 WMI를 사용합니다. 기본값은 Packet입니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 기본값: Windows 인증.
  • 없음: COM 인증이 없습니다.
  • 연결: 연결 수준 COM 인증.
  • 통화: 통화 수준 COM 인증.
  • 패킷: 패킷 수준 COM 인증.
  • PacketIntegrity: 패킷 무결성 수준 COM 인증.
  • PacketPrivacy: 패킷 개인 정보 수준 COM 인증.
  • 변경되지 않음: 이전 명령과 동일합니다.

이 매개 변수의 값에 대한 자세한 내용은 AuthenticationLevel을 참조하세요.

형식:AuthenticationLevel
별칭:Authentication
허용되는 값:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:Packet
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

컴퓨터를 즉시 종료합니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Impersonation

이 cmdlet이 WMI를 호출할 때 사용할 가장 수준을 지정합니다. 기본값은 Impersonate입니다.

Stop-Computer 는 WMI를 사용합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 기본값: 기본 가장입니다.
  • 익명: 호출자의 ID를 숨깁니다.
  • 식별: 개체가 호출자의 자격 증명을 쿼리할 수 있도록 허용합니다.
  • 가장: 개체가 호출자의 자격 증명을 사용할 수 있도록 허용합니다.
형식:ImpersonationLevel
허용되는 값:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Default value:Impersonate
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Protocol

컴퓨터를 다시 시작하는 데 사용할 프로토콜을 지정합니다. 이 매개 변수에 허용되는 값은 WSMan 및 DCOM입니다. 기본값은 DCOM입니다.

이 매개 변수는 PowerShell 3.0에서 도입되었습니다.

형식:String
허용되는 값:DCOM, WSMan
Position:Named
Default value:DCOM
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ThrottleLimit

이 명령을 실행하도록 설정할 수 있는 최대 동시 연결 수를 지정합니다. 이 매개 변수를 생략하거나 0 값을 입력하면 기본값 32가 사용됩니다.

제한 제한은 세션이나 컴퓨터가 아닌 현재 명령에만 적용됩니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WsmanAuthentication

이 cmdlet에서 WSMan 프로토콜을 사용할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 기본값은 Default입니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Basic
  • CredSSP
  • 기본값
  • 다이제스트
  • Kerberos
  • 교섭하다.

이 매개 변수의 값에 대한 자세한 내용은 AuthenticationMechanism을 참조하세요.

주의

인증할 원격 컴퓨터에 사용자 자격 증명이 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

이 매개 변수는 PowerShell 3.0에서 도입되었습니다.

형식:String
허용되는 값:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:Default
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

System.Management.Automation.RemotingJob

AsJob 매개 변수를 사용하는 경우 이 cmdlet은 RemotingJob 개체를 반환합니다.

참고

이 cmdlet은 다음을 사용합니다. Win32Shutdown WMI 클래스의 Win32_OperatingSystem 메서드입니다. 이 방법을 사용하려면 컴퓨터를 종료하는 SeShutdownPrivilege 데 사용되는 사용자 계정에 대한 권한을 사용하도록 설정해야 합니다.