Win32_OperatingSystem 클래스의 Shutdown 메서드

ShutdownWMI 클래스 메서드는 컴퓨터를 끄면 안전할 때까지 프로그램 및 DLL을 언로드합니다.

이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.

구문

uint32 Shutdown();

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

성공을 나타내기 위해 0을 반환합니다. 다른 모든 숫자는 오류를 나타냅니다. 오류 코드는 WMI 오류 상수 또는 WbemErrorEnum을 참조하세요. 일반적인 HRESULT 값은시스템 오류 코드를 참조하세요.

성공 (0)

기타 (1 4294967295)

설명

컴퓨터가 제대로 작동하지 않거나 구성 프로세스를 완료하기 위해 예약된 유지 관리를 위해 네트워크에서 컴퓨터를 제거해야 하는 경우도 있습니다. 예를 들어 DHCP 서버가 잘못된 IP 주소를 전달하는 경우 문제를 해결하기 위해 서비스 기술자를 디스패치할 수 있을 때까지 컴퓨터를 종료할 수 있습니다. 보안 위반이 발생한 것으로 의심되는 경우 보안 문제가 해결될 때까지 액세스할 수 없도록 특정 서버를 종료해야 할 수 있습니다. 일부 구성 작업(예: 컴퓨터 이름 변경)에서는 변경 내용이 적용되기 전에 컴퓨터를 다시 시작해야 합니다.

이 메서드는 가능하면 컴퓨터를 즉시 종료합니다. 시스템은 실행 중인 모든 프로세스를 중지하고 모든 파일 버퍼를 디스크로 플러시한 다음 시스템 전원을 풉니다. 호출 프로세스에는 다음 예제에 설명된 대로 SE_SHUTDOWN_NAME 권한이 있어야 합니다.

Set OpSysSet = GetObject("winmgmts:{(Shutdown)}//./root/cimv2").ExecQuery("select * from Win32_OperatingSystem where Primary=true")

권한 설정에 대한 자세한 내용은 권한 있는 작업 실행 및 VBScript를 사용하여 권한 있는 작업 실행을 참조하세요. 로그오프 또는 강제 종료와 같은 추가 종료 옵션은 Win32Shutdown 메서드를 참조하세요.

예제

다음 VBScript 코드는 로컬 컴퓨터를 종료합니다.

참고

Shutdown 메서드를 성공적으로 호출하려면 종료 권한이 있어야 합니다.

Set OpSysSet = GetObject("winmgmts:{(Shutdown)}//./root/cimv2").ExecQuery("select * from Win32_OperatingSystem where Primary=true")

for each OpSys in OpSysSet
 OpSys.Shutdown()
next

다음 Perl 코드는 로컬 컴퓨터를 종료합니다.

참고

Shutdown 메서드를 성공적으로 호출하려면 종료 권한이 있어야 합니다.

use strict;
use Win32::OLE;

my $OpSysSet;

eval { $OpSysSet = Win32::OLE->GetObject("winmgmts:{(Shutdown)}//./root/cimv2")->
      ExecQuery("SELECT * FROM Win32_OperatingSystem WHERE Primary=true"); };

if(!$@ && defined $OpSysSet)
{
 close (STDERR);
 foreach my $OpSys (in $OpSysSet)
 {
  my $RetVal = $OpSys->Shutdown();
  if (!defined $RetVal || $RetVal != 0)
  { 
   print Win32::OLE->LastError, "\n";
  }
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

다음 VBScript 코드는 지정된 원격 컴퓨터를 종료합니다. 종료할 원격 시스템의 이름으로 REMOTE_SYSTEM_NAME 입력합니다.

참고

Shutdown 메서드를 성공적으로 호출하려면 RemoteShutdown 권한이 있어야 합니다.

Set OpSysSet = GetObject("winmgmts:{(Debug,RemoteShutdown)}//REMOTE_SYSTEM_NAME/root/cimv2").ExecQuery("select * from Win32_OperatingSystem where Primary=true")

for each OpSys in OpSysSet
 OpSys.Shutdown()
next

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

운영 체제 클래스

Win32_OperatingSystem

WMI 작업: 데스크톱 관리

VBScript를 사용하여 권한 있는 작업 실행