Nombre de proveedor

Registry

Unidades

HKLM:, HKCU:

Descripción breve

Proporciona acceso a las claves y valores del Registro del sistema desde Windows PowerShell.

Descripción detallada

El proveedor del Registro de Windows PowerShell permite obtener, agregar, cambiar, borrar y eliminar claves y valores del Registro en Windows PowerShell.

Las claves del Registro se representan como instancias de la clase Microsoft.Win32.RegistryKey. Los valores del Registro se representan como instancias de la clase PSCustomObject.

El proveedor del Registro permite tener acceso a un espacio de nombres jerárquico que consta de claves y subclaves del Registro. Los datos y valores del Registro no son componentes de esta jerarquía. En su lugar, son propiedades de cada una de las claves.

El proveedor del Registro admite todos los cmdlets que contienen el sustantivo Item (cmdlets Item), como Get-Item, Copy-Item y Rename-Item. Los cmdlets Item se deben usar cuando se trabaja con claves y subclaves del Registro. El proveedor del Registro también admite los cmdlets que contienen el sustantivo ItemProperty (cmdlets ItemProperty). Los cmdlets ItemProperty se deben usar cuando se trabaja con datos y valores del Registro. No se pueden usar los cmdlets que contienen el sustantivo Content (cmdlets Content) con el proveedor del Registro.

Cada clave del Registro está protegida por un descriptor de seguridad. Se puede usar Get-Acl para ver el descriptor de seguridad de una clave.

Capacidades

ShouldProcess

Ejemplos

Desplazarse 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 muestra la ubicación actual:

get-location

Administrar claves del Registro

-------------------------- EJEMPLO 1 --------------------------

Este comando muestra información acerca de 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 quita 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 muestra información acerca de 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 propiedades y todas las subclaves y propiedades a 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 muestra el descriptor de seguridad para el elemento del Registro especificado:

get-acl -path hkcu:\environment\testnew | format-list -property *

Administrar entradas del Registro

-------------------------- EJEMPLO 1 --------------------------

Este comando muestra el nombre de valor y los datos de valor para cada entrada del Registro en la clave del Registro HKEY_CURRENT_USER\Environment:

get-itemproperty -path hkcu:\Environment

Se devuelve la entrada predeterminada del Registro sólo si tiene un valor.

-------------------------- EJEMPLO 2 --------------------------

Este comando muestra el nombre de valor y los datos de valor para cada entrada del Registro Temp en la clave del Registro 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 y establece su valor en pstestvalue:

new-itemproperty -path hkcu:\environment -name "pstest" -value "pstestvalue"

-------------------------- EJEMPLO 4 --------------------------

Este comando actualiza el valor de la entrada del Registro pstest a updatedvalue en la clave HKEY_CURRENT_USER\Environment:

set-itemproperty -path hkcu:\environment -name pstest 
-value "updatedvalue"

-------------------------- EJEMPLO 5 --------------------------

Este comando cambia el nombre del valor de nombre de la entrada del Registro pstest a pstestnew en la clave HKEY_CURRENT_USER\Environment:

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

El cmdlet Clear-Item se puede usar para borrar el valor de la entrada predeterminada del Registro para una subclave. Por ejemplo, el comando siguiente 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 quita la entrada del Registro pstestnew de la clave del Registro HKEY_CURRENT_USER\Environment\testnew:

remove-itemproperty -path hkcu:\environment\testnew `
-name pstestnew

-------------------------- EJEMPLO 10 --------------------------

Este comando actualiza el valor de la entrada del Registro predeterminada a "default value" en la clave HKEY_CURRENT_USER\Environment\testnew:

set-itemproperty -path hkcu:\environment\testnew `
-name "(default)" -value "default value"

También se puede actualizar 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 los parámetros de cmdlet que un proveedor de Windows PowerShell agrega y solo están disponibles cuando el cmdlet se utiliza en la unidad habilitada por el proveedor.

Type <Microsoft.Win32.RegistryValueKind>

Especifica los tipos de datos que se han de utilizar al almacenar valores en el Registro, o identifica el tipo de datos de un valor en el Registro.

Value Description

String

Especifica una cadena terminada en NULL. Es equivalente a REG_SZ.

ExpandString

Especifica una cadena terminada en NULL que contiene referencias sin expandir a las variables de entorno que se expanden cuando se recupera el valor. Es equivalente a REG_EXPAND_SZ.

Binary

Especifica datos binarios en cualquier formato. Es equivalente a REG_BINARY.

DWord

Especifica un número binario de 32 bits. Es equivalente a REG_DWORD.

MultiString

Especifica una matriz de cadenas terminadas en NULL que finalizan con dos caracteres NULL. Es equivalente a REG_MULTI_SZ.

QWord

Especifica un número binario de 64 bits. Es equivalente a REG_QWORD.

Unknown

Indica un tipo de datos del Registro no admitido, como REG_RESOURCE_LIST.

Cmdlets admitidos

Vea también




Tabla de contenido