Freigeben über

WMI-Aufgaben: Registrierung

  • Artikel

WMI-Aufgaben für die Registrierung zum Erstellen und Ändern von Registrierungsschlüsseln und -werten. Weitere Beispiele finden Sie im TechNet ScriptCenter unter https://www.microsoft.com/technet.

In den in diesem Artikel enthaltenen Skriptbeispielen werden nur Daten vom lokalen Computer abgerufen. Weitere Informationen zum Verwenden des Skripts zum Abrufen von Daten von Remotecomputern finden Sie unter Herstellen einer Verbindung mit WMI auf einem Remotecomputer.

Nachstehend wird die Skriptausführung näher beschrieben.

So führen Sie ein Skript aus

  1. Kopieren Sie den Code, und speichern Sie ihn in einer Datei mit VBS-Erweiterung, z. B. filename.vbs. Stellen Sie sicher, dass der Text-Editor der Datei keine TXT-Erweiterung hinzufügt.
  2. Öffnen Sie ein Eingabeaufforderungsfenster, und navigieren Sie zu dem Verzeichnis, in dem Sie die Datei gespeichert haben.
  3. Geben Sie cscript filename.vbs in die Eingabeaufforderung ein.
  4. Wenn Sie nicht auf ein Ereignisprotokoll zugreifen können, überprüfen Sie, ob Sie eine Eingabeaufforderung mit erhöhten Rechten verwenden. Einige Ereignisprotokolle, z. B. das Sicherheitsereignisprotokoll, können durch die Benutzerkontensteuerung (User Account Control, UAC) geschützt sein.

Hinweis

Standardmäßig zeigt cscript die Ausgabe eines Skripts im Eingabeaufforderungsfenster an. Da WMI-Skripts sehr viele Ausgabedaten erzeugen können, sollten Sie die Ausgabe in eine Datei umleiten. Geben Sie cscript filename.vbs > outfile.txt in die Eingabeaufforderung ein, um die Ausgabe des Skripts filename.vbs an outfile.txt umzuleiten.

In der folgenden Tabelle sind Skriptbeispiele aufgeführt, die zum Abrufen verschiedener Datentypen vom lokalen Computer verwendet werden können.

Vorgehensweisen WMI-Klassen oder -Methoden
Lesen eines Registrierungsschlüsselwerts mithilfe von WMI Verwenden Sie die Klasse StdRegProv, die sich im Namespace „root\default“ befindet. Sie können keine Instanzen dieser Klasse abrufen, da der Systemregistrierungsanbieter ein reiner Methoden- und Ereignisanbieter ist. Sie können jedoch Registrierungsdaten über Methoden wie EnumKey oder EnumValue abrufen. Win32_Registry ist im Namespace „root\cimv2“ enthalten und ruft Daten über die Registrierung als Ganzes ab, z. B. deren Größe.
VB 
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
Erstellen eines neuen Registrierungsschlüssels

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methode CreateKey.

VB 
              
              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"}
Erstellen eines neuen Registrierungswerts unter einem Schlüssel

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methode CreateKey. Verwenden Sie anschließend je nach Datentyp des Registrierungswerts eine der Set-Methoden, z. B. SetDWORDValue. Die Set-Methoden erzeugen einen Wert, falls dieser nicht schon vorhanden ist. Weitere Informationen finden Sie unter Zuordnen eines Registrierungsdatentyps zu einem WMI-Datentyp.

VB 
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"}
Vermeiden eines Fehlers „Ungültige Klasse“ beim Schreiben eines Skripts zum Lesen der Registrierung

Verwenden Sie beim Zugriff auf die Klasse StdRegProv den Namespace „root\default“. StdRegProv ist nicht im Namespace „cimv2“ enthalten. Deshalb wird eine Fehlermeldung „Ungültige Klasse“ generiert, wenn Sie versuchen, eine Verbindung mit „root\cimv2:StdRegProv“ herzustellen.

VB 
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
Überprüfen der Sicherheit für einen spezifischen Registrierungsschlüssel

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methode CheckAccess. Sie können die Zugriffsrechte nur für die Benutzer*innen überprüfen, die das Skript oder die Anwendung derzeit ausführen. Die Zugriffsrechte für andere angegebene Benutzer*innen können nicht überprüft werden.
Lesen und Schreiben binärer Registrierungswerte

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methoden GetBinaryValue und SetBinaryValue. Registrierungswerte, die im Hilfsprogramm RegEdt32 als eine Reihe von Byte-Hexadezimalwerten angezeigt werden, haben das Datenformat REG_BINARY. Weitere Informationen finden Sie unter Zuordnen eines Registrierungsdatentyps zu einem WMI-Datentyp. Im folgenden VBScript-Codebeispiel wird ein neuer Schlüssel mit einem Binärwert erstellt. Der Binärwert wird im Bytearray iValues bereitgestellt, das im Hexadezimalformat angegeben ist.

VB 
              
              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

Das folgende Skript liest den Binärwert.

VB 
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")}
Lesen und Schreiben von Registrierungswerten, die mehrere Zeichenfolgen enthalten

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methoden GetMultiStringValue und SetMultiStringValue. Registrierungsschlüssel, die im Hilfsprogramm RegEdt32 als eine Reihe von durch Leerzeichen getrennten Zeichenfolgen angezeigt werden, haben das Datenformat REG_MULTI_SZ. Weitere Informationen finden Sie unter Zuordnen eines Registrierungsdatentyps zu einem WMI-Datentyp. Das folgende VBScript-Codebeispiel erstellt einen neuen Schlüssel und einen neuen mehrteiligen Zeichenfolgenwert.

VB 
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"}

Das folgende Skript liest den mehrteiligen Zeichenfolgenwert.

VB 
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
Entfernen eines Registrierungsschlüssels

Verwenden Sie die Klasse StdRegProv (enthalten im Namespace „root\default“) und die Methode 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-Aufgaben für Skripts und Anwendungen

WMI-C++-Anwendungsbeispiele

TechNet ScriptCenter

Ändern der Systemregistrierung

StdRegProv