El cmdlet Rename-ItemProperty cambia el nombre de una propiedad de elemento especificada.
No se cambia el valor de la propiedad.
Por ejemplo, puede usar Rename-ItemProperty para cambiar el nombre de una entrada del Registro.
Ejemplos
Ejemplo 1: Cambiar el nombre de una entrada del Registro
Este comando cambia el nombre de la entrada del Registro de configuración contenida en la clave HKEY_LOCAL_MACHINE\Software\SmpApplication a "oldconfig".
Este parámetro no es compatible con ningún proveedor instalado con PowerShell.
Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.
Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.
Especifica un filtro para calificar el parámetro Path. El proveedor de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro de FileSystem en about_Wildcards.
Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.
Obliga al cmdlet a cambiar el nombre de una propiedad de un objeto al que el usuario no puede tener acceso de otro modo.
La implementación varía de proveedor a proveedor.
Para obtener más información, consulte about_Providers.
Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como "*.txt". Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.
Especifica una ruta de acceso al elemento. El valor de LiteralPath se usa tal como está escrito. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Puede pasar una cadena que contenga una ruta, pero no una ruta literal, a este cmdlet.
Salidas
None, System.Management.Automation.PSCustomObject
Este cmdlet genera un PSCustomObject que representa la propiedad de elemento cuyo nombre ha cambiado, si especifica el parámetro passThru . De lo contrario, este cmdlet no genera ninguna salida.
Notas
Remove-ItemProperty está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.