WMI タスク: レジストリ

[アーティクル]
06/29/2023

レジストリの WMI タスクが、レジストリキーと値を作成および変更します。その他の例については、https://www.microsoft.com/technet の TechNet ScriptCenter を参照してください。

このトピックに示したスクリプト例では、ローカルコンピューターからのみデータを取得します。スクリプトを使用してリモートコンピューターからデータを取得する方法の詳細については、「リモートコンピューター上の WMI への接続」を参照してください。

以下の手順では、スクリプトの実行方法を説明します。

スクリプトを実行するには

コードをコピーし、拡張子 .vbs を付けたファイル (filename.vbs など) に保存します。テキストエディターによってファイルに .txt 拡張子が追加されていないことを確認します。
コマンドプロンプトウィンドウを開き、ファイルを保存したディレクトリに移動します。
コマンドプロンプトで「cscript filename.vbs」と入力します。
イベントログにアクセスできない場合は、管理者特権でのコマンドプロンプトから実行しているかどうかを確認します。セキュリティイベントログなどの一部のイベントログは、ユーザーアクセス制御 (UAC) によって保護されている場合があります。

注意

既定では、cscript により、コマンドプロンプトウィンドウにスクリプトの出力が表示されます。 WMI スクリプトでは大量の出力が生成される可能性があるため、出力をファイルにリダイレクトすることが必要になる場合があります。コマンドプロンプトで「cscript filename.vbs > outfile.txt」と入力し、filename.vbs スクリプトの出力を outfile.txt にリダイレクトします。

次の表に、ローカルコンピューターからさまざまな種類のデータを取得するために使用できるスクリプトの例の一覧を示します。

操作方法 WMI のクラスまたはメソッド

...どのようにして WMI を使用してレジストリキー値を読み取りますか?

root\default 名前空間にある StdRegProv クラスを使用します。このクラスのインスタンスを取得できないのは、システムレジストリプロバイダーはメソッドとイベントのプロバイダーでしかないからです。ただし、EnumKey や EnumValue などのメソッドを使用してレジストリデータを取得することができます。 Win32_Registry は root\cimv2 名前空間にあり、レジストリ全体に関するデータ (どのくらい大きいのかなど) を取得します。

const HKEY_CURRENT_USER = &H80000001
strComputer = "."
Set oReg=GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv")
strKeyPath = "Console"
strValueName = "HistoryBufferSize"
oReg.GetDWORDValue HKEY_CURRENT_USER,strKeyPath,strValueName,dwValue
WScript.Echo "Current History Buffer Size: " & dwValue

PowerShell

$HKEY_CURRENT_USER =2147483649
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$Key = "Console"
$Value = "HistoryBufferSize"
$results = $reg.GetDWORDValue($HKEY_CURRENT_USER, $Key, $value)
"Current History Buffer Size: {0}" -f $results.uValue

...どのようにして新しいレジストリキーを作成しますか?

root\default 名前空間にある StdRegProv クラスと、CreateKey メソッドを使用します。

              
              const HKEY_LOCAL_MACHINE = &H80000002 strComputer = "." Set objReg=GetObject( "winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv") strKeyPath = "SOFTWARE\NewKey"
objReg.CreateKey HKEY_LOCAL_MACHINE,strKeyPath
WScript.Echo "Created registry key HKEY_LOCAL_MACHINE\SOFTWARE\NewKey"

PowerShell

$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$Key     = "SOFTWARE\NewKey"
$results   = $reg.CreateKey($HKEY_LOCAL_MACHINE, $Key)
If ($results.Returnvalue -eq 0) {"Key created"}

...どのようにして新しいレジストリ値をキーの下に作成しますか?

root\default 名前空間にある StdRegProv クラスと、CreateKey メソッドを使用します。次に、値のレジストリデータ型に応じて、Set メソッドの 1 つ (SetDWORDValue など) を使用します。 Set メソッドは値を、まだ存在しない場合に作成します。詳細については、「レジストリデータ型を WMI データ型へのマッピング」を参照してください。

Const HKEY_LOCAL_MACHINE = &H80000002
strKeyPath = "SOFTWARE\NewKey"
strComputer = "."
Set objReg=GetObject( "winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv")
strValueName = "Example_Expanded_String_Value"
strValue = "%PATHEXT%"
objReg.SetExpandedStringValue HKEY_LOCAL_MACHINE,strKeyPath,strValueName,strValue
WScript.Echo "Example expanded_String_Value at " & "HKEY_LOCAL_MACHINE\SOFTWARE\NewKey"

PowerShell

$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$ValueName = "Example_Expanded_String_Value"
$Value     = "%PATHEXT%"
$Key       = "SOFTWARE\NewKey"
$results   = $reg.SetExpandedStringValue($HKEY_LOCAL_MACHINE, $Key, $ValueName, $Value)
If ($results.Returnvalue -eq 0) {"Value created"}

...レジストリを読み取るためのスクリプトを記述しようとしたときに、どのようにして無効なクラスエラーが発生しないようにしますか?

StdRegProv クラスにアクセスするときに root\default 名前空間を使用します。 StdRegProv は cimv2 名前空間の一部ではありません。そのため、"root\cimv2:StdRegProv" に接続しようとすると"無効なクラス" エラーが発生します。

Const HKEY_CURRENT_USER = &H80000001
strComputer = "."
Set oReg=GetObject( "winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv") 
strKeyPath = "Console"
strValueName = "HistoryBufferSize"
oReg.GetDWORDValue HKEY_CURRENT_USER, strKeyPath, strValueName, dwValue
Wscript.Echo "Current History Buffer Size: " & dwValue

...どのようにして特定のレジストリキーのセキュリティをチェックしますか?

root\default 名前空間にある StdRegProv クラスと、CheckAccess メソッドを使用します。チェックできるのは、スクリプトやアプリケーションを実行している現在のユーザーのアクセス権のみです。他の指定されたユーザーのアクセス権をチェックすることはできません。

...どのようにしてバイナリレジストリ値の読み取りと書き込みを行いますか?

"Root\Default" 名前空間にある StdRegProv クラスと、GetBinaryValue および SetBinaryValue のメソッドを使用します。一連のバイト 16 進値として RegEdt32 ユーティリティに表示されるレジストリ値は、REG_BINARY データ形式です。詳細については、「レジストリデータ型を WMI データ型へのマッピング」を参照してください。次の VBScript コード例は、バイナリ値を持つ新しいキーを作成します。バイナリ値は、16 進数で指定された iValues バイト配列に提供されます。

              
              const HKEY_LOCAL_MACHINE = &H80000002 strKeyPath = "SOFTWARE\NewKey" strComputer = "." iValues = Array(&H01,&Ha2,&H10) Set oReg=GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv") oReg.CreateKey HKEY_LOCAL_MACHINE,strKeyPath strKeyPath = "SOFTWARE\NewKey" BinaryValueName = "Example Binary Value" oReg.SetBinaryValue HKEY_LOCAL_MACHINE,strKeyPath,BinaryValueName,iValues

次のスクリプトは、バイナリ値を読み取ります。

const HKEY_LOCAL_MACHINE = &H80000002 
strKeyPath = "SOFTWARE\NewKey"
strValueName = "Example Binary Value"
strComputer = "."
dim iValues(3)
Set oReg=GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv")
oReg.GetBinaryValue HKEY_LOCAL_MACHINE,strKeyPath,strValueName,iValues
For i = lBound(iValues) to uBound(iValues)
Wscript.Echo iValues(i)
Next

PowerShell

$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$ValueName = "Example Binary Value"
$Values     = @(0x54, 0x46, 0x4C)
$Key       = "SOFTWARE\NewKey"
$results   = $reg.GetBinaryValue($HKEY_LOCAL_MACHINE, $Key, $ValueName)
Foreach ($byte in $results.uvalue) {"{0}" -f $byte.tostring("x")}

...どのようにして複数の文字列を含むレジストリ値の読み取りと書き込みをしますか?

root\default 名前空間にある StdRegProv クラスと、GetMultiStringValue および SetMultiStringValue メソッドを使用します。 RegEdt32 ユーティリティにスペースで区切られた一連の文字列として表示されるレジストリキーは、REG_MULTI_SZ データ形式です。詳細については、「レジストリデータ型を WMI データ型へのマッピング」を参照してください。次の VBScript コード例は、新しいキーと新しい複数文字列値を作成します。

const HKEY_LOCAL_MACHINE = &H80000002
strKeyPath = "SOFTWARE\NewKey"
MultValueName = "Example Multistring Value"
strComputer = "."
iValues = Array("string1", "string2")
Set oReg=GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv")
oReg.CreateKey HKEY_LOCAL_MACHINE,strKeyPath
oReg.SetMultiStringValue HKEY_LOCAL_MACHINE,strKeyPath,MultValueName,iValues

PowerShell

$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$Key       = "SOFTWARE\NewKey"
$ValueName = "Example MultiString Value"
$Values     = @("Thomas", "Susan", "Rebecca")
$Key       = "SOFTWARE\NewKey"
$results   = $reg.SetMultiStringValue($HKEY_LOCAL_MACHINE, $Key, $ValueName, $Values)
If ($results.Returnvalue -eq 0) {"Value Set"}

次のスクリプトは、複数文字列の値を読み取ります。

const HKEY_LOCAL_MACHINE = &H80000002
strKeyPath = "SOFTWARE\NewKey"
strComputer = "."
iValues = Array("string1", "string2")
Set oReg=GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\default:StdRegProv")
MultValueName = "Example Multistring Value"
oReg.GetMultiStringValue HKEY_LOCAL_MACHINE,strKeyPath,MultValueName,iValues
For Each strValue In iValues
WScript.echo strValue
Next

PowerShell

# Define Constants
$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$Key       = "SOFTWARE\NewKey"
$ValueName = "Example MultiString Value"
$results   = $reg.GetMultiStringValue($HKEY_LOCAL_MACHINE, $Key, $ValueName)
$results.svalue

...どのようにしてレジストリキーを削除しますか?

root\default 名前空間にある StdRegProv クラスと、DeleteKey メソッドを使用します。

PowerShell

$HKEY_Local_Machine =2147483650 
$computer ='.'
$reg = [WMIClass]"ROOT\DEFAULT:StdRegProv"
$Key     = "SOFTWARE\NewKey"
$results   = $reg.DeleteKey($HKEY_LOCAL_MACHINE, $Key)
If ($results.Returnvalue -eq 0) {"Key Removed"}

スクリプトおよびアプリケーション用の WMI タスク
WMI C++ アプリケーションの例
TechNet ScriptCenter
システムレジストリの変更
StdRegProv

次の方法で共有

WMI タスク: レジストリ

フィードバック

その他のリソース

次の方法で共有

WMI タスク: レジストリ

関連トピック

フィードバック

その他のリソース