Proveedor del Registro
Se aplica a: Windows PowerShell 4.0, Windows PowerShell 5.0
NOMBRE DEL PROVEEDOR
Registro
UNIDADES
HKLM:, HKCU:
DESCRIPCIÓN BREVE
Proporciona acceso a las claves, entradas y valores del Registro en Windows PowerShell.
DESCRIPCIÓN DETALLADA
El proveedor del Registro de Windows PowerShell permite obtener, agregar, cambiar, borrar y eliminar claves, entradas y valores del Registro en Windows PowerShell.
Las claves del Registro se representan como instancias de la clase Microsoft.Win32.RegistryKey. Las entradas del Registro se representan como instancias de la clase PSCustomObject.
El proveedor del Registro permite acceder a un espacio de nombres jerárquico que consta de claves y subclaves del Registro. Los valores y las entradas del Registro no forman parte de esa jerarquía. En su lugar, son propiedades de cada una de las claves.
El proveedor del Registro es compatible con todos los cmdlets que contienen el nombre Item (los cmdlets Item), como Get-Item, Copy-Item y Rename-Item, excepto el cmdlet Invoke-Item. Use los cmdlets Item cuando trabaje con claves y subclaves del Registro.
El proveedor de Registro también admite los cmdlets que contienen el nombre ItemProperty (los cmdlets ItemProperty). Use los cmdlets ItemProperty cuando trabaje con entradas del Registro. No puede usar los cmdlets que contengan el nombre Content (los cmdlets Content) con el proveedor del Registro.
Cada clave del Registro está protegida por un descriptor de seguridad. Puede usar Get-Acl para ver el descriptor de seguridad de una clave.
FUNCIONALIDADES
ShouldProcess, UseTransactions
EJEMPLOS
Navegar por el Registro
-------------------------- EJEMPLO 1 --------------------------
Este comando establece la ubicación actual en la clave del Registro HKEY_LOCAL_MACHINE\Software.
set-location hklm:\software
-------------------------- EJEMPLO 2 --------------------------
Este comando obtiene un objeto que representa la ubicación actual:
get-location
Administrar claves del Registro
-------------------------- EJEMPLO 1 --------------------------
Este comando obtiene cada subclave inmediata de la clave del Registro HKEY_LOCAL_MACHINE\Software:
get-childitem -path hklm:\software
-------------------------- EJEMPLO 2 --------------------------
Este comando crea la subclave TestNew bajo la subclave HKCU:\Environment:
new-item -path hkcu:\Environment\TestNew
-------------------------- EJEMPLO 3 --------------------------
Este comando elimina la subclave TestNew de la clave HKEY_CURRENT_USER\Environment:
remove-item -path hkcu:\Environment\TestNew
-------------------------- EJEMPLO 4 --------------------------
Este comando copia la clave TestNew en la subclave TestCopy:
copy-item -path hkcu:\Environment\TestNew hkcu:\Environment\TestNew\TestCopy
-------------------------- EJEMPLO 5 --------------------------
Este comando obtiene todas las subclaves de la clave del Registro HKEY_LOCAL_MACHINE\Software:
get-childitem -path hklm:\Software -recurse
-------------------------- EJEMPLO 6 --------------------------
Este comando mueve la clave del Registro HKEY_CURRENT_USER\Environment\testnewcopy, sus subclaves y sus entradas del Registro a la clave HKEY_CURRENT_USER\Environment\testnew:
move-item -path hkcu:\environment\testnewcopy -destination hkcu:\environment\testnew
-------------------------- EJEMPLO 7 --------------------------
Este comando cambia el nombre de la clave del Registro HKEY_CURRENT_USER\Environment\testnew a HKEY_CURRENT_USER\Environment\test:
rename-item -path hkcu:\environment\testnew\ -newname test
-------------------------- EJEMPLO 8 --------------------------
Este comando obtiene el descriptor de seguridad de la clave del Registro especificada:
get-acl -path hkcu:\environment\testnew | format-list -property *
Administrar entradas del Registro
-------------------------- EJEMPLO 1 --------------------------
Este comando obtiene las entradas del Registro en la clave del Registro HKEY_CURRENT_USER\Environment:
get-itemproperty -path hkcu:\Environment
Este comando obtiene la entrada del Registro Default solo si contiene datos.
-------------------------- EJEMPLO 2 --------------------------
Este comando obtiene la entrada del Registro Temp en la clave HKEY_CURRENT_USER\Environment:
get-itemproperty -path hkcu:\Environment -name Temp
-------------------------- EJEMPLO 3 --------------------------
Este comando crea la entrada del Registro PSTest en la clave HKEY_CURRENT_USER\Environment y establece su valor en 1:
new-itemproperty -path hkcu:\environment -name PSTest -value 1 -propertyType dword
-------------------------- EJEMPLO 4 --------------------------
Este comando cambia el valor de la entrada del Registro PSTest en la clave HKEY_CURRENT_USER\Environment a "Start" y cambia su tipo de datos a REG_SZ (cadena):
set-itemproperty -path hkcu:\environment -name PSTest -value Start -type string
-------------------------- EJEMPLO 5 --------------------------
Este comando cambia el nombre de la entrada del Registro Temp en la clave HKEY_CURRENT_USER\Environment a PSTestNew:
rename-itemproperty -path hkcu:\environment -name PSTest
-newname PSTestNew
-------------------------- EJEMPLO 6 --------------------------
Este comando copia la entrada del Registro PSTestNew de la clave HKEY_CURRENT_USER\Environment a la clave HKEY_CURRENT_USER\Environment\testnewcopy:
copy-itemproperty -path hkcu:\environment -destination hkcu:\environment\testnewcopy -name pstestnew
-------------------------- EJEMPLO 7 --------------------------
Este comando mueve la entrada del Registro pstestnew de la clave HKEY_CURRENT_USER\environment\testnewcopy a la clave HKEY_CURRENT_USER\environment\testnew:
move-itemproperty -path hkcu:\environment\testnewcopy -destination hkcu:\environment\testnew -name pstestnew
-------------------------- EJEMPLO 8 --------------------------
Este comando borra el valor de la entrada del Registro pstestnew en la clave HKEY_CURRENT_USER\Environment\testnew:
clear-itemproperty -path hkcu:\environment\testnew -name pstestnew
Puede usar el cmdlet Clear-Item para borrar el valor de la entrada de Registro predeterminada para una subclave. Por ejemplo, el siguiente comando borra el valor de la entrada predeterminada de la clave del Registro HKEY_CURRENT_USER\Environment\testnew: clear-item -path hkcu:\environment\testnew.
-------------------------- EJEMPLO 9 --------------------------
Este comando elimina la entrada del Registro pstestnew de la clave de Registro HKEY_CURRENT_USER\Environment\testnew:
remove-itemproperty -path hkcu:\environment\testnew -name pstestnew
-------------------------- EJEMPLO 10 --------------------------
Este comando cambia el valor de la entrada del Registro predeterminada en la clave HKEY_CURRENT_USER\Environment\testnew a "default value":
set-itemproperty -path hkcu:\environment\testnew -name "(default)" -value "default value"
También puede cambiar el valor predeterminado de una clave del Registro mediante el cmdlet Set-Item. Por ejemplo, el comando siguiente actualiza el valor predeterminado de la clave testnew: set-item -path hkcu:\environment\testnew -value "another default value".
PARÁMETROS DINÁMICOS
Los parámetros dinámicos son parámetros de cmdlet agregados por un proveedor de Windows PowerShell que solo están disponibles cuando se utiliza el cmdlet en la unidad habilitada por el proveedor.
Type <Microsoft.Win32.RegistryValueKind>
Establece o cambia el tipo de datos de un valor del Registro. El valor predeterminado es String (REG_SZ).
Este parámetro funciona tal y como se ha diseñado en el cmdlet Set-ItemProperty. También está disponible en cmdlet Set-Item en las unidades del Registro, pero no tiene ningún efecto.
| Valor | Descripción |
|---|---|
Cadena |
Especifica una cadena terminada en null. Equivalente a REG_SZ. |
ExpandString |
Especifica una cadena terminada en null que contiene referencias no expandidas a variables de entorno que se expanden cuando se recupera el valor. Equivalente a REG_EXPAND_SZ. |
Binary |
Especifica datos binarios en cualquier formato. Equivalente a REG_BINARY. |
DWord |
Especifica un número binario de 32 bits. Equivalente a REG_DWORD. |
MultiString |
Especifica una matriz de cadenas terminadas en null, finalizada con dos caracteres null. Equivalente a REG_MULTI_SZ. |
QWord |
Especifica un número binario de 64 bits. Equivalente a REG_QWORD. |
Unknown |
Indica un tipo de datos del Registro no admitido, como REG_RESOURCE_LIST. |