영어로 읽기

다음을 통해 공유


Stop-Computer

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

구문

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-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 변수에서 ComputerName 매개 변수의 컴퓨터 목록으로 지정된 컴퓨터를 종료합니다. Force 매개 변수는 즉시 종료됩니다. 자격 증명 매개 변수는 $c 변수에 저장된 자격 증명을 제출합니다.

매개 변수

-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같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 생성된 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

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

참고

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

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

-Force

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

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

-WsmanAuthentication

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

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

  • 기초의
  • 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은 출력을 반환하지 않습니다.

참고

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

PowerShell 7.1에서는 Linux 및 macOS용 Stop-Computer 추가되었습니다. 이러한 플랫폼의 경우 cmdlet은 네이티브 명령 /sbin/shutdown호출합니다.