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

구문

Stop-Computer [[-ComputerName] <string[]>] [[-Credential] <PSCredential>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Force] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Stop-Computer cmdlet은 컴퓨터를 원격으로 종료합니다. 로컬 컴퓨터도 종료할 수 있습니다.

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

이 cmdlet에서는 AsJob 매개 변수를 사용하는 경우 외에는 Windows PowerShell 원격이 필요하지 않습니다.

매개 변수

-AsJob

명령을 백그라운드 작업으로 실행합니다.

참고: 이 매개 변수를 사용하려면 로컬 및 원격 컴퓨터를 원격을 사용하도록 구성해야 하고 Windows Vista 이상의 경우 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 열어야 합니다. 자세한 내용은 about_Remote_Requirements를 참조하십시오.

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

Windows PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs를 참조하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Authentication <AuthenticationLevel>

WMI 연결에 사용할 인증 수준을 지정합니다. Stop-Computer는 WMI를 사용합니다. 기본값은 Packet입니다.

유효한 값은 다음과 같습니다.

Unchanged: 인증 수준이 이전 명령과 동일합니다.

Default: Windows 인증

None: COM 인증 안 함

Connect: 연결 수준 COM 인증

Call: 호출 수준 COM 인증

Packet: 패킷 수준 COM 인증

PacketIntegrity: 패킷 무결성 수준 COM 인증

PacketPrivacy: 패킷 개인 정보 수준 COM 인증

필수 여부

false

위치

named

기본값

4

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ComputerName <string[]>

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

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

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

필수 여부

false

위치

1

기본값

.

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Credential <PSCredential>

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

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에 의해 생성된 것과 같은 PSCredential 개체를 입력합니다.

필수 여부

false

위치

2

기본값

Current user

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Force

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

필수 여부

false

위치

named

기본값

False

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Impersonation <ImpersonationLevel>

WMI를 호출할 때 사용할 가장 수준을 지정합니다. Stop-Computer는 WMI를 사용합니다. 기본값은 "Impersonate"입니다.

유효한 값은 다음과 같습니다.

Default: 기본 가장

Anonymous: 호출자의 ID를 숨깁니다.

Identify: 개체가 호출자의 자격 증명을 쿼리할 수 있도록 허용합니다.

Impersonate: 개체가 호출자의 자격 증명을 사용할 수 있도록 허용합니다.

필수 여부

false

위치

named

기본값

Impersonate

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ThrottleLimit <int>

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

스로틀 한도는 현재 명령에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

필수 여부

false

위치

named

기본값

32

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

입력을 이 cmdlet으로 파이프할 수 없습니다.

출력

없음 또는 System.Management.Automation.RemotingJob

AsJob 매개 변수를 사용하는 경우 cmdlet은 작업 개체(System.Management.Automation.RemotingJob)를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

이 cmdlet은 Win32_OperatingSystem WMI 클래스의 Win32Shutdown 메서드를 사용합니다.

예 1

C:\PS>stop-computer

설명
-----------
이 명령은 로컬 컴퓨터를 종료합니다.






예 2

C:\PS>stop-computer -computername Server01, Server02, localhost

설명
-----------
이 명령은 Server01과 Server02이라는 두 원격 컴퓨터와 "localhost"로 식별되는 로컬 컴퓨터를 종료합니다.






예 3

C:\PS>$j = stop-computer -computername Server01, Server02 -asjob 

C:\PS> $results = $j | receive-job

C:\PS> $results

설명
-----------
이들 명령은 두 원격 컴퓨터에서 Stop-Computer 명령을 백그라운드 작업으로 실행한 다음 결과를 가져옵니다.

첫 번째 명령은 AsJob 매개 변수를 사용하여 명령을 백그라운드 작업으로 실행합니다. 이 명령은 결과 작업 개체를 $j 변수에 저장합니다.

두 번째 명령은 파이프라인 연산자를 사용하여 $j의 작업 개체를 Receive-Job cmdlet으로 보내 작업 결과를 가져옵니다. 그런 다음 이 명령은 $results 변수에 결과를 저장합니다. 

세 번째 명령은 $results 변수에 저장된 결과를 표시합니다.

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






예 4

C:\PS>stop-computer -comp Server01 -impersonation anonymous -authentication PacketIntegrity

설명
-----------
이 명령은 Server01 원격 컴퓨터를 다시 시작합니다. 이 명령은 사용자 지정된 가장 및 인증 설정을 사용합니다.






예 5

C:\PS>$s = get-content domain01.txt

C:\PS> $c = get-credential domain01\admin01

C:\PS> stop-computer -computername $s -force -throttlelimit 10 -credential $c

설명
-----------
이들 명령은 Domain01에 있는 모든 컴퓨터를 즉시 강제로 종료합니다. 

첫 번째 명령은 도메인의 컴퓨터 목록을 가져와 $s 변수에 저장합니다.

두 번째 명령은 도메인 관리자의 자격 증명을 가져와 $c 변수에 저장합니다.

세 번째 명령은 컴퓨터를 종료합니다. 이 명령은 ComputerName 매개 변수를 사용하여 $s 변수에 있는 컴퓨터 목록을 전송하고 Force 매개 변수를 사용하여 즉시 강제로 종료하며 Credential 매개 변수를 사용하여 $c 변수에 저장된 자격 증명을 전송합니다. 또한 ThrottleLimit 매개 변수를 사용하여 10개의 동시 연결로 명령을 제한합니다.






참고 항목




목차