Anbietername
Registry
Laufwerke
HKLM:, HKCU:
Kurzbeschreibung
Bietet Zugriff aus Windows PowerShell auf die Registrierungsschlüssel und -werte des Systems.
Ausführliche Beschreibung
Mit dem Windows PowerShell-Registry-Anbieter können Sie Registrierungsschlüssel und -werte in Windows PowerShell abrufen, hinzufügen, ändern, entfernen und löschen.
Registrierungsschlüssel werden als Instanzen der Microsoft.Win32.RegistryKey-Klasse dargestellt. Registrierungswerte werden als Instanzen der PSCustomObject-Klasse dargestellt.
Mit dem Registry-Anbieter können Sie auf einen hierarchischen Namespace zugreifen, der aus Registrierungsschlüsseln und -unterschlüsseln besteht. Registrierungswerte und -daten sind keine Bestandteile dieser Hierarchie. Sie sind stattdessen Eigenschaften der einzelnen Schlüssel.
Der Registry-Anbieter unterstützt alle Cmdlets mit dem Substantiv "Item" (Item-Cmdlets) wie "Get-Item", "Copy-Item" und "Rename-Item". Verwenden Sie die Item-Cmdlets, wenn Sie mit Registrierungsschlüsseln und -unterschlüsseln arbeiten. Der Registry-Anbieter unterstützt auch die Cmdlets mit dem Substantiv "ItemProperty" (ItemProperty-Cmdlets). Verwenden Sie die ItemProperty-Cmdlets, wenn Sie mit Registrierungswerten und -daten arbeiten. Die Cmdlets mit dem Substantiv "Content" (Content-Cmdlets) können nicht mit dem Registry-Anbieter verwendet werden.
Jeder Registrierungsschlüssel wird durch eine Sicherheitsbeschreibung geschützt. Mit "Get-Acl" können Sie die Sicherheitsbeschreibung eines Schlüssels anzeigen.
Funktionen
ShouldProcess
Beispiele
Navigieren in der Registrierung
-------------------------- BEISPIEL 1 --------------------------
Mit diesem Befehl wird der aktuelle Speicherort auf den Registrierungsschlüssel "HKEY_LOCAL_MACHINE\Software" festgelegt.
set-location hklm:\software
-------------------------- BEISPIEL 2 --------------------------
Mit diesem Befehl wird der aktuelle Speicherort angezeigt:
get-location
Verwalten von Registrierungsschlüsseln
-------------------------- BEISPIEL 1 --------------------------
Mit diesem Befehl werden Informationen über jeden direkten Unterschlüssel des Registrierungsschlüssels "HKEY_LOCAL_MACHINE\Software" angezeigt.
get-childitem -path hklm:\software
-------------------------- BEISPIEL 2 --------------------------
Mit diesem Befehl wird der Unterschlüssel "TestNew" unter dem Unterschlüssel "HKCU:\Environment" erstellt:
new-item -path hkcu:\Environment\TestNew
-------------------------- BEISPIEL 3 --------------------------
Mit diesem Befehl wird der Unterschlüssel "TestNew" des Schlüssels "HKEY_CURRENT_USER\Environment" entfernt:
remove-item -path hkcu:\Environment\TestNew
-------------------------- BEISPIEL 4 --------------------------
Mit diesem Befehl wird der Schlüssel "TestNew" in den Unterschlüssel "TestCopy" kopiert:
copy-item -path hkcu:\Environment\TestNew hkcu:\Environment\TestNew\TestCopy
-------------------------- BEISPIEL 5 --------------------------
Mit diesem Befehl werden Informationen über alle Unterschlüssel des Registrierungsschlüssels "HKEY_LOCAL_MACHINE\Software" angezeigt:
get-childitem -path hklm:\Software -recurse
-------------------------- BEISPIEL 6 --------------------------
Mit diesem Befehl werden der Registrierungsschlüssel "HKEY_CURRENT_USER\Environment\testnewcopy" und dessen Eigenschaften mit allen zugehörigen Unterschlüsseln und deren Eigenschaften nach "HKEY_CURRENT_USER\Environment\testnewcopy" verschoben.
move-item -path hkcu:\environment\testnewcopy ` -destination hkcu:\environment\testnew
-------------------------- BEISPIEL 7 --------------------------
Mit diesem Befehl wird der Registrierungsschlüssel "HKEY_CURRENT_USER\Environment\testnew" in "HKEY_CURRENT_USER\Environment\test" umbenannt:
rename-item -path hkcu:\environment\testnew\ -newname test
-------------------------- BEISPIEL 8 --------------------------
Mit diesem Befehl wird die Sicherheitsbeschreibung für das angegebene Registrierungselement angezeigt:
get-acl -path hkcu:\environment\testnew | format-list -property *
Verwalten von Registrierungseinträgen
-------------------------- BEISPIEL 1 --------------------------
Mit diesem Befehl werden der Name und die Daten des Werts für jeden Registrierungseintrag im Registrierungsschlüssel "HKEY_CURRENT_USER\Environment" angezeigt:
get-itemproperty -path hkcu:\Environment
Der Registrierungseintrag "Default" wird nur zurückgegeben, wenn er einen Wert aufweist.
-------------------------- BEISPIEL 2 --------------------------
Mit diesem Befehl werden der Name und die Daten des Werts für den Registrierungseintrag "Temp"im Registrierungsschlüssel "HKEY_CURRENT_USER\Environment" angezeigt:
get-itemproperty -path hkcu:\Environment -name Temp
-------------------------- BEISPIEL 3 --------------------------
Mit diesem Befehl wird der Registrierungseintrag "pstest" im Schlüssel "HKEY_CURRENT_USER" erstellt und dessen Wert auf "pstestvalue" festgelegt.
new-itemproperty -path hkcu:\environment -name "pstest" -value "pstestvalue"
-------------------------- BEISPIEL 4 --------------------------
Mit diesem Befehl wird der Wert des Registrierungseintrags "pstest" im Schlüssel "HKEY_CURRENT_USER\Environment" in "updatedvalue" aktualisiert:
set-itemproperty -path hkcu:\environment -name pstest -value "updatedvalue"
-------------------------- BEISPIEL 5 --------------------------
Mit diesem Befehl wird der Name des Werts für den Registrierungseintrag "pstest" im Schlüssel "HKEY_CURRENT_USER\Environment" in "pstestnew" umbenannt:
rename-itemproperty -path hkcu:\environment -name pstest ` -newname pstestnew
-------------------------- BEISPIEL 6 --------------------------
Mit diesem Befehl wird der Registrierungseintrag "pstestnew" aus dem Schlüssel "HKEY_CURRENT_USER\Environment" in den Schlüssel "HKEY_CURRENT_USER\Environment\testnewcopy" kopiert:
copy-itemproperty -path hkcu:\environment ` -destination hkcu:\environment\testnewcopy -name pstestnew
-------------------------- BEISPIEL 7 --------------------------
Mit diesem Befehl wird der Registrierungseintrag "pstestnew" aus dem Schlüssel "HKEY_CURRENT_USER\environment\testnewcopy" in den Schlüssel "HKEY_CURRENT_USER\environment\testnew" verschoben:
move-itemproperty -path hkcu:\environment\testnewcopy ' -destination hkcu:\environment\testnew -name pstestnew
-------------------------- BEISPIEL 8 --------------------------
Mit diesem Befehl wird der Wert des Registrierungseintrags "pstestnew" im Schlüssel "HKEY_CURRENT_USER\Environment\testnew" gelöscht:
clear-itemproperty -path hkcu:\environment\testnew -name pstestnew
Mit dem Cmdlet "Clear-Item" können Sie den Wert des Registrierungseintrags "Default" für einen Unterschlüssel löschen. Beispielsweise wird mit dem folgenden Befehl der Wert des Default-Eintrags des Registrierungsschlüssels "HKEY_CURRENT_USER\Environment\testnew" gelöscht: clear-item -path hkcu:\environment\testnew
-------------------------- BEISPIEL 9 --------------------------
Mit diesem Befehl wird der Registrierungseintrag "pstestnew" aus dem Registrierungsschlüssel "HKEY_CURRENT_USER\Environment\testnew" entfernt:
remove-itemproperty -path hkcu:\environment\testnew ` -name pstestnew
-------------------------- BEISPIEL 10 --------------------------
Mit diesem Befehl wird der Wert des Registrierungseintrags "Default" im Schlüssel "HKEY_CURRENT_USER\Environment\testnew" in "default value" aktualisiert:
set-itemproperty -path hkcu:\environment\testnew ` -name "(default)" -value "default value"
Sie können den Standardwert eines Registrierungsschlüssels auch mit dem Cmdlet "Set-Item" aktualisieren. Mit dem folgenden Befehl wird beispielsweise der Standardwert des Schlüssels "testnew" aktualisiert: set-item -path hkcu:\environment\testnew -value "another default value"
Dynamische Parameter
Bei dynamischen Parametern handelt es sich um Cmdlet-Parameter, die von einem Windows PowerShell-Anbieter hinzugefügt werden und nur verfügbar sind, wenn das Cmdlet auf dem Anbieterlaufwerk verwendet wird.
Type <Microsoft.Win32.RegistryValueKind>
Gibt die beim Speichern von Werten in der Registrierung zu verwendenden Datentypen an oder identifiziert den Datentyp eines Werts in der Registrierung.
| Value | Description |
|---|---|
String |
Gibt eine Zeichenfolge an, die auf NULL endet. Entspricht REG_SZ. |
ExpandString |
Gibt eine auf NULL endende Zeichenfolge an, die nicht erweiterte Verweise auf Umgebungsvariablen enthält, die beim Abrufen des Werts erweitert werden. Entspricht REG_EXPAND_SZ. |
Binary |
Gibt Binärdaten in einem beliebigen Format an. Entspricht REG_BINARY. |
DWord |
Gibt eine 32-Bit-Binärzahl an. Entspricht REG_DWORD. |
MultiString |
Gibt ein Array von Zeichenfolgen an, die mit zwei NULL-Zeichen enden. Entspricht REG_MULTI_SZ. |
QWord |
Gibt eine 64-Bit-Binärzahl an. Entspricht REG_QWORD. |
Unknown |
Gibt einen nicht unterstützten Registrierungsdatentyp an, beispielsweise REG_RESOURCE_LIST. |
Unterstützte Cmdlets
Siehe auch