Stop-Computer
로컬 및 원격 컴퓨터를 중지(종료)합니다.
구문
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 매개 변수를 사용하여 종료 작업을 백그라운드 작업으로 실행하고, 인증 수준 및 대체 자격 증명을 지정하고, 명령을 실행하기 위해 생성된 동시 연결을 제한하고, 즉시 종료를 강제할 수 있습니다.
이 cmdlet은 AsJob 매개 변수를 사용하지 않는 한 Windows PowerShell 원격이 필요하지 않습니다.
예제
예제 1: 로컬 컴퓨터 종료
PS C:\> Stop-Computer
이 명령은 로컬 컴퓨터를 종료합니다.
예제 2: 두 개의 원격 컴퓨터와 로컬 컴퓨터 종료
PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"
이 명령은 두 개의 원격 컴퓨터, Server01 및 Server02 및 localhost로 식별된 로컬 컴퓨터를 중지합니다.
예제 3: 백그라운드 작업으로 원격 컴퓨터 종료
PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results
이러한 명령은 두 원격 컴퓨터에서 백그라운드 작업으로 컴퓨터 중지 실행한 다음 결과를 가져옵니다.
첫 번째 명령은 명령을 백그라운드 작업으로 실행하는 AsJob 매개 변수를 지정합니다. 이 명령은 결과 작업 개체를 $j 변수에 저장합니다.
두 번째 명령은 파이프라인 연산자를 사용하여 작업 결과를 가져오는 receive-Job
세 번째 명령은 $results 변수에 저장된 결과를 표시합니다.
AsJob 로컬 컴퓨터에서 작업을 만들고 결과를 자동으로 로컬 컴퓨터에 반환하므로 Receive-Job 로컬 명령으로 실행할 수 있습니다.
예제 4: 원격 컴퓨터 종료
PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity
이 명령은 Server01 원격 컴퓨터를 중지합니다. 이 명령은 사용자 지정된 가장 및 인증 설정을 사용합니다.
예제 5:
PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
이러한 명령은 Domain01의 모든 컴퓨터를 즉시 종료합니다.
첫 번째 명령은 도메인의 컴퓨터 목록을 가져오고 $s 변수에 저장합니다.
두 번째 명령은 도메인 관리자의 자격 증명을 가져오고 $c 변수에 저장합니다.
세 번째 명령은 컴퓨터를 종료합니다. 이 매개 변수는 ComputerName 매개 변수를 사용하여 $s 변수의 컴퓨터 목록, 강제 매개 변수를 사용하여 즉시 종료하고 자격 증명 매개 변수를 사용하여 $c 변수에 저장된 자격 증명을 제출합니다. 또한 ThrottleLimit 매개 변수를 사용하여 명령을 10개의 동시 연결로 제한합니다.
매개 변수
-AsJob
이 cmdlet이 백그라운드 작업으로 실행됨을 나타냅니다.
이 매개 변수를 사용하려면 원격으로 로컬 및 원격 컴퓨터를 구성해야 하며 Windows Vista 이상 버전의 Windows 운영 체제에서는 관리자 권한으로 실행 옵션을 사용하여 Windows PowerShell을 열어야 합니다. 자세한 내용은 about_Remote_Requirements 참조하세요.
AsJob 매개 변수를 지정하면 명령이 백그라운드 작업을 나타내는 개체를 즉시 반환합니다. 작업이 완료되는 동안 세션에서 작업을 계속할 수 있습니다. 작업이 로컬 컴퓨터에 만들어지고 원격 컴퓨터의 결과가 자동으로 로컬 컴퓨터로 반환됩니다. 작업 결과를 얻으려면 Receive-Job cmdlet을 사용합니다.
Windows PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs 참조하세요.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerName
중지할 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.
쉼표로 구분된 목록에 하나 이상의 컴퓨터의 NETBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 또는 localhost를 입력합니다.
이 매개 변수는 Windows 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과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 PSCredential 개체를 입력합니다.
형식: | PSCredential |
Position: | 1 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DcomAuthentication
이 cmdlet이 WMI와 함께 사용하는 인증 수준을 지정합니다. 중지 컴퓨터 WMI를 사용합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 기본값. Windows 인증
- 없음. COM 인증 없음
- 연결하다. 연결 수준 COM 인증
- 외침. 호출 수준 COM 인증
- 패킷. 패킷 수준 COM 인증
- PacketIntegrity. 패킷 무결성 수준 COM 인증
- PacketPrivacy. 패킷 개인 정보 수준 COM 인증
- 변경. 이전 명령과 동일
기본값은 Packet입니다.
이 매개 변수의 값에 대한 자세한 내용은 MSDN 라이브러리의 AuthenticationLevel 열거형 참조하세요.
형식: | AuthenticationLevel |
별칭: | Authentication |
허용되는 값: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Force
컴퓨터를 즉시 종료합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Impersonation
이 cmdlet이 WMI를 호출할 때 사용할 가장 수준을 지정합니다. 중지 컴퓨터 WMI를 사용합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 기본값. 기본 가장입니다.
- 익명의. 호출자의 ID를 숨깁니다.
- 식별. 개체가 호출자의 자격 증명을 쿼리할 수 있도록 허용합니다.
- 가장. 개체가 호출자의 자격 증명을 사용할 수 있도록 허용합니다.
기본값은 Impersonate입니다.
형식: | ImpersonationLevel |
허용되는 값: | Default, Anonymous, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Protocol
컴퓨터를 다시 시작하는 데 사용할 프로토콜을 지정합니다. 이 매개 변수에 허용되는 값은 WSMan 및 DCOM입니다. 기본값은 DCOM입니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
형식: | String |
허용되는 값: | DCOM, WSMan |
Position: | Named |
Default value: | None |
필수: | 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 프로토콜을 사용할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 기초의
- CredSSP
- 기본값
- 소화하다
- Kerberos
- 교섭하다.
기본값은 Default입니다.
이 매개 변수의 값에 대한 자세한 내용은 MSDN 라이브러리의 AuthenticationMechanism 열거형 참조하세요.
주의: 인증할 원격 컴퓨터에 사용자 자격 증명이 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터에 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.
이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.
형식: | String |
허용되는 값: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
None
이 cmdlet에 입력을 파이프할 수 없습니다.
출력
None or System.Management.Automation.RemotingJob
AsJob 매개 변수를 지정하면 이 cmdlet은 System.Management.Automation.RemotingJob 개체를 반환합니다. 그렇지 않으면 출력을 생성하지 않습니다.
참고
- 이 cmdlet은 Win32_OperatingSystem WMI 클래스의 Win32Shutdown 메서드를 사용합니다.
- Windows PowerShell 2.0에서는 원격 컴퓨터를 다시 시작/중지할 때 AsJob 매개 변수가 안정적으로 작동하지 않습니다. Windows PowerShell 3.0에서는 이 문제를 해결하기 위해 구현이 변경됩니다.