Stop-Computer
로컬 및 원격 컴퓨터를 중지(종료)합니다.
구문
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Stop-Computer cmdlet은 로컬 컴퓨터와 원격 컴퓨터를 종료합니다.
Stop-Computer 매개 변수를 사용하여 인증 수준 및 대체 자격 증명을 지정하고 즉시 종료할 수 있습니다.
PowerShell 7.1에서는 Linux 및 macOS용 Stop-Computer 추가되었습니다. 매개 변수는 이러한 플랫폼에 영향을 주지 않습니다. cmdlet은 네이티브 명령 /sbin/shutdown호출합니다.
예제
예제 1: 로컬 컴퓨터 종료
다음은 로컬 컴퓨터를 종료하는 예제입니다.
Stop-Computer -ComputerName localhost
예제 2: 두 개의 원격 컴퓨터와 로컬 컴퓨터 종료
이 예제에서는 두 개의 원격 컴퓨터와 로컬 컴퓨터를 중지합니다.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer
ComputerName 매개 변수를 사용하여 두 개의 원격 컴퓨터와 로컬 컴퓨터를 지정합니다. 각 컴퓨터가 종료됩니다.
예제 3: 백그라운드 작업으로 원격 컴퓨터 종료
이 예제에서는 Stop-Computer 두 원격 컴퓨터에서 백그라운드 작업으로 실행됩니다.
백그라운드 연산자 &Stop-Computer 명령을 백그라운드 작업으로 실행합니다. 자세한 내용은, about_Operators참조하세요.
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer
ComputerName 매개 변수를 사용하여 두 개의 원격 컴퓨터를 지정합니다.
& 백그라운드 연산자는 명령을 백그라운드 작업으로 실행합니다. 작업 개체는 $j 변수에 저장됩니다.
$j 변수의 작업 개체는 파이프라인 아래로 전송되어 작업 결과를 가져오는 Receive-Job. 개체는 $results 변수에 저장됩니다.
$results 변수는 PowerShell 콘솔에 작업 정보를 표시합니다.
예제 4: 원격 컴퓨터 종료
다음은 지정된 인증을 사용하여 원격 컴퓨터를 종료하는 예제입니다.
Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos
Stop-Computer
ComputerName 매개 변수를 사용하여 원격 컴퓨터를 지정합니다.
WsmanAuthentication 매개 변수는 Kerberos를 사용하여 원격 연결을 설정하도록 지정합니다.
예제 5: 도메인에서 컴퓨터 종료
이 예제에서 명령은 지정된 도메인에 있는 모든 컴퓨터를 즉시 종료합니다.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c
Get-Content
Path 매개 변수를 사용하여 도메인 컴퓨터 목록이 있는 현재 디렉터리에 파일을 가져옵니다. 개체는 $s 변수에 저장됩니다.
Get-Credential
자격 증명 매개 변수를 사용하여 도메인 관리자의 자격 증명을 지정합니다. 자격 증명은 $c 변수에 저장됩니다.
Stop-Computer
변수에서 $s 매개 변수의 컴퓨터 목록으로 지정된 컴퓨터를 종료합니다.
Force 매개 변수는 즉시 종료됩니다.
자격 증명 매개 변수는 $c 변수에 저장된 자격 증명을 제출합니다.
매개 변수
-ComputerName
중지할 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.
쉼표로 구분된 목록에 하나 이상의 컴퓨터의 NETBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 또는 localhost를 입력합니다.
이 매개 변수는 PowerShell 리모팅을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수를 사용할 수 있습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 중국, __서버, 서버, 아이피 주소 |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Credential
이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
User01 또는 Domain01\User01같은 사용자 이름을 입력하거나 cmdlet에서 생성된 Get-Credential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.
자격 증명은 PSCredential 개체에 저장되고 암호는 SecureString저장됩니다.
비고
SecureString 데이터 보호에 대한 자세한 내용은 SecureString이 얼마나 안전한가요?.
매개 변수 속성
| 형식: | PSCredential |
| Default value: | Current user |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
컴퓨터를 즉시 종료합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WsmanAuthentication
이 cmdlet에서 WSMan 프로토콜을 사용할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 기본값은 Default.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- 기초
- CredSSP
- 기본값
- 요약
- Kerberos
- 교섭하다.
이 매개 변수의 값에 대한 자세한 내용은 AuthenticationMechanism참조하세요.
주의
인증할 원격 컴퓨터에 사용자 자격 증명이 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터에 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.
이 매개 변수는 PowerShell 3.0에서 도입되었습니다.
매개 변수 속성
| 형식: | String |
| Default value: | Default |
| 허용되는 값: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
None
개체를 이 cmdlet에 파이프로 연결할 수 없습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
이 cmdlet은 다음을 사용합니다.
Win32Shutdown WMI 클래스의 Win32_OperatingSystem 메서드입니다. 이 방법을 사용하려면 컴퓨터를 종료하는 데 사용되는 사용자 계정에 대해 SeShutdownPrivilege 권한을 사용하도록 설정해야 합니다.
PowerShell 7.1에서는 Linux 및 macOS용 Stop-Computer 추가되었습니다. 이러한 플랫폼의 경우 cmdlet은 네이티브 명령 /sbin/shutdown호출합니다.