Stop-Computer
로컬 및 원격 컴퓨터를 중지(종료)합니다.
구문
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 |
기본값 |
현재 사용자 |
파이프라인 입력 적용 여부 |
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개의 동시 연결로 명령을 제한합니다.
참고 항목
개념
Add-Computer
Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Test-Connection