Win32_Process クラスの Terminate メソッド
TerminateWMI クラス メソッドは、プロセスとそのすべてのスレッドを終了します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 Terminate(
[in] uint32 Reason
);
パラメーター
-
Reason [in]
-
プロセスの終了コードと、この呼び出しの結果として終了したすべてのスレッドのコード。
戻り値
プロセスが正常に終了した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。 その他のエラー コードについては、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
正常に完了しました (0)
-
アクセスが拒否されました (2)
-
特権が不足しています (3)
-
不明なエラー (8)
-
パスが見つかりません (9)
-
無効なパラメーター (21)
-
その他 (22 4294967295)
注釈
概要
多くの場合、コンピューターの問題は、想定どおりに動作しなくなったプロセスが原因です。 たとえば、プロセスがメモリをリークしているか、ユーザー入力への応答が停止している可能性があります。 このような問題が発生した場合は、プロセスを終了する必要があります。 これは単純な十分なタスクのように思えるかもしれませんが、プロセスの終了は、いくつかの要因によって複雑になる可能性があります。
- プロセスがハングしている可能性があるため、アプリケーションを閉じるためにメニューまたはキーボード コマンドに応答しなくなります。 これにより、一般的なユーザーがアプリケーションを閉じ、プロセスを終了することが不可能になります。
- プロセスが孤立している可能性があります。 たとえば、スクリプトで Word のインスタンスを作成し、そのインスタンスを破棄せずに終了する場合があります。 実際には、ユーザー インターフェイスが表示されていない場合でも、Wordはコンピューター上で実行されたままです。 ユーザー インターフェイスがないため、プロセスを終了するために使用できるメニュー コマンドやキーボード コマンドはありません。
- 終了する必要があるプロセスがわからない場合があります。 たとえば、指定したメモリ量を超えるプログラムをすべて終了できます。
- タスク マネージャーでは、作成したプロセスのみを終了できるため、コンピューターの管理者であっても、プロセスを終了できない場合があります。
スクリプトを使用すると、これらの潜在的な障害をすべて克服し、コンピューターに対するかなりの管理制御を提供できます。 たとえば、ユーザーがorganizationで禁止されているゲームをプレイしていると思われる場合は、各コンピューターに接続するスクリプトを簡単に記述し、ゲームが実行されているかどうかを特定し、すぐにプロセスを終了できます。
Terminate メソッドの使用
プロセスは、次の方法で終了できます。
- 現在実行中のプロセスを終了する。 たとえば、リモート コンピューターで実行されている診断プログラムを終了する必要がある場合があります。 アプリケーションをリモートで制御する方法がない場合は、そのアプリケーションのプロセスを終了するだけです。
- 最初にプロセスが実行されないようにする。 コンピューター上でプロセスの作成を継続的に監視することで、プロセスが開始されるとすぐにプロセスを特定して即座に終了できます。 これにより、特定のアプリケーション (インターネット経由で大きなメディア ファイルをダウンロードするプログラムなど) が特定のコンピューターで実行されないようにする 1 つの方法が提供されます。
注意
グループ ポリシーを使用して、コンピューター上で実行されるプログラムを制限することもできます。 ただし、グループ ポリシーは、[スタート] メニューまたは Windows エクスプローラーを使用して実行されるプログラムのみを制限できます。コマンド ラインなどの他の方法で起動されたプログラムには影響しません。 これに対し、WMI では、プロセスの開始方法に関係なく、プロセスの実行を妨げる可能性があります。
所有していないプロセスを終了する
所有していないプロセスを終了するには、 SeDebugPrivilege 特権を有効にします。 VBScript では、次のコード行を使用してこの特権を有効にすることができます。
Set objLoc = createobject("wbemscripting.swbemlocator")
objLoc.Security_.privileges.addasstring "sedebugprivilege", true
C++ でこの特権を有効にする方法の詳細については、「C++ での 特権の有効化と無効化」を参照してください。
例
TechNet ギャラリー の複数のサーバーでの実行プロセスの終了 PowerShell コード サンプルは、1 台または複数のコンピューターで実行されているプロセスを終了します。
次の VBScript サンプルでは、アプリケーション Diagnose.exeが現在実行されているプロセスを終了します。
strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colProcessList = objWMIService.ExecQuery("SELECT * FROM Win32_Process WHERE Name = 'Diagnose.exe'")
For Each objProcess in colProcessList
objProcess.Terminate()
Next
次の VBScript サンプルでは、一時的なイベント コンシューマーを使用して、プロセスが開始されるとすぐに終了します。
strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colMonitoredProcesses = objWMIService.ExecNotificationQuery("SELECT * FROM __InstanceCreationEvent " _
& " WITHIN 1 WHERE TargetInstance ISA 'Win32_Process'")
i = 0
Do While i = 0
Set objLatestProcess = colMonitoredProcesses.NextEvent
If objLatestProcess.TargetInstance.Name = "Download.exe" Then
objLatestProcess.TargetInstance.Terminate()
End If
Loop
次の VBScript コード例は、リモート コンピューターに接続し、そのコンピューターのNotepad.exeを終了します。
strComputer = "FullComputerName"
strDomain = "DOMAIN"
strUser = InputBox("Enter user name")
strPassword = InputBox("Enter password")
Set objSWbemLocator = CreateObject("WbemScripting.SWbemLocator")
Set objWMIService = objSWbemLocator.ConnectServer(strComputer, _
"root\CIMV2", _
strUser, _
strPassword, _
"MS_409", _
"ntlmdomain:" + strDomain)
Set colProcessList = objWMIService.ExecQuery("SELECT * FROM Win32_Process WHERE Name = 'notepad.exe'")
For Each objProcess in colProcessList
objProcess.Terminate()
Next
次の C++ コードは、ローカル コンピューター上のNotepad.exe プロセスを終了します。 プロセスを終了するコードで または プロセス ハンドル (プロセス ID) を指定します。 この値は、 Win32_Process クラスの handle プロパティ (クラスのキー プロパティ) にあります。 Handle プロパティの値を指定することで、終了するクラスのインスタンスへのパスを指定します。 リモート コンピューターへの接続の詳細については、「 例: リモート コンピューターから WMI データを取得する」を参照してください。
#define _WIN32_DCOM
#include <iostream>
using namespace std;
#include <comdef.h>
#include <Wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")
int main(int iArgCnt, char ** argv)
{
HRESULT hres;
// Step 1: --------------------------------------------------
// Initialize COM. ------------------------------------------
hres = CoInitializeEx(0, COINIT_MULTITHREADED);
if (FAILED(hres))
{
cout << "Failed to initialize COM library. Error code = 0x"
<< hex << hres << endl;
return 1; // Program has failed.
}
// Step 2: --------------------------------------------------
// Set general COM security levels --------------------------
// Note: If you are using Windows 2000, specify -
// the default authentication credentials for a user by using
// a SOLE_AUTHENTICATION_LIST structure in the pAuthList ----
// parameter of CoInitializeSecurity ------------------------
hres = CoInitializeSecurity(
NULL,
-1, // COM negotiates service
NULL, // Authentication services
NULL, // Reserved
RPC_C_AUTHN_LEVEL_DEFAULT, // Default authentication
RPC_C_IMP_LEVEL_IMPERSONATE, // Default Impersonation
NULL, // Authentication info
EOAC_NONE, // Additional capabilities
NULL // Reserved
);
if (FAILED(hres))
{
cout << "Failed to initialize security. Error code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Step 3: ---------------------------------------------------
// Obtain the initial locator to WMI -------------------------
IWbemLocator *pLoc = NULL;
hres = CoCreateInstance(
CLSID_WbemLocator,
0,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator, (LPVOID *) &pLoc);
if (FAILED(hres))
{
cout << "Failed to create IWbemLocator object. "
<< "Err code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Step 4: ---------------------------------------------------
// Connect to WMI through the IWbemLocator::ConnectServer method
IWbemServices *pSvc = NULL;
// Connect to the local root\cimv2 namespace
// and obtain pointer pSvc to make IWbemServices calls.
hres = pLoc->ConnectServer(
_bstr_t(L"ROOT\\CIMV2"),
NULL,
NULL,
0,
NULL,
0,
0,
&pSvc
);
if (FAILED(hres))
{
cout << "Could not connect. Error code = 0x"
<< hex << hres << endl;
pLoc->Release();
pSvc->Release();
CoUninitialize();
return 1; // Program has failed.
}
cout << "Connected to ROOT\\CIMV2 WMI namespace" << endl;
// Step 5: --------------------------------------------------
// Set security levels for the proxy ------------------------
hres = CoSetProxyBlanket(
pSvc, // Indicates the proxy to set
RPC_C_AUTHN_WINNT, // RPC_C_AUTHN_xxx
RPC_C_AUTHZ_NONE, // RPC_C_AUTHZ_xxx
NULL, // Server principal name
RPC_C_AUTHN_LEVEL_CALL, // RPC_C_AUTHN_LEVEL_xxx
RPC_C_IMP_LEVEL_IMPERSONATE, // RPC_C_IMP_LEVEL_xxx
NULL, // client identity
EOAC_NONE // proxy capabilities
);
if (FAILED(hres))
{
cout << "Could not set proxy blanket. Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Step 6: --------------------------------------------------
// Use the IWbemServices pointer to make requests of WMI ----
// Set up to call the Win32_Process::Create method
BSTR ClassName = SysAllocString(L"Win32_Process");
/* YOU NEED TO CHANGE THE NUMBER VALUE OF THE HANDLE
(PROCESS ID) TO THE CORRECT VALUE OF THE PROCESS YOU
ARE TRYING TO TERMINATE (this provides a path to
the class instance you are tying to terminate). */
BSTR ClassNameInstance = SysAllocString(
L"Win32_Process.Handle=\"3168\"");
_bstr_t MethodName = (L"Terminate");
BSTR ParameterName = SysAllocString(L"Reason");
IWbemClassObject* pClass = NULL;
hres = pSvc->GetObject(ClassName, 0, NULL, &pClass, NULL);
IWbemClassObject* pInParamsDefinition = NULL;
IWbemClassObject* pOutMethod = NULL;
hres = pClass->GetMethod(MethodName, 0,
&pInParamsDefinition, &pOutMethod);
if (FAILED(hres))
{
cout << "Could not get the method. Error code = 0x"
<< hex << hres << endl;
}
IWbemClassObject* pClassInstance = NULL;
hres = pInParamsDefinition->SpawnInstance(0, &pClassInstance);
// Create the values for the in parameters
VARIANT pcVal;
VariantInit(&pcVal);
V_VT(&pcVal) = VT_I4;
// Store the value for the in parameters
hres = pClassInstance->Put(L"Reason", 0,
&pcVal, 0);
// Execute Method
hres = pSvc->ExecMethod(ClassNameInstance, MethodName, 0,
NULL, pClassInstance, NULL, NULL);
if (FAILED(hres))
{
cout << "Could not execute method. Error code = 0x"
<< hex << hres << endl;
VariantClear(&pcVal);
SysFreeString(ClassName);
SysFreeString(MethodName);
pClass->Release();
pInParamsDefinition->Release();
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Clean up
//--------------------------
VariantClear(&pcVal);
SysFreeString(ClassName);
SysFreeString(MethodName);
pClass->Release();
pInParamsDefinition->Release();
pLoc->Release();
pSvc->Release();
CoUninitialize();
return 0;
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|