Rename-ItemProperty

Cambia el nombre de una propiedad de un elemento.

Sintaxis

Rename-ItemProperty [-LiteralPath] <string> [-Name] <string> [-NewName] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Rename-ItemProperty [-Path] <string> [-Name] <string> [-NewName] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Descripción

El cmdlet Rename-ItemProperty cambia el nombre de la propiedad de un elemento especificado. El valor de la propiedad no cambia. Por ejemplo, puede utilizar Rename-ItemProperty para cambiar el nombre de una entrada del Registro.

Parámetros

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.

Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Exclude <string[]>

Omite los elementos especificados. Se permite el uso de caracteres comodín.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Filter <string>

Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Force

Permite al cmdlet cambiar el nombre de una propiedad de un objeto al que el usuario no puede obtener acceso de ningún otro modo. La implementación varía según el proveedor. Para obtener más información, vea about_Providers.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Include <string[]>

Especifica únicamente aquellos elementos sobre los que actuará el cmdlet, y excluye a todos los demás.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-LiteralPath <string>

Especifica la ruta de la propiedad del elemento. El valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Name <string>

Especifica el nombre actual de la propiedad cuyo nombre se va a cambiar.

¿Requerido?	true
¿Posición?	2
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-NewName <string>

Especifica el nuevo nombre de la propiedad.

¿Requerido?	true
¿Posición?	3
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-PassThru

Devuelve un objeto que representa la propiedad del elemento. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Path <string>

Especifica la ruta del elemento cuyo nombre se va a cambiar.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByValue, ByPropertyName)
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	System.String Puede canalizar a Rename-ItemProperty una cadena que contiene una ruta de acceso (que no sea una ruta de acceso literal).
Salidas	Ninguno o System.Management.Automation.PSCustomObject Cuando se usa el parámetro PassThru, Rename-ItemProperty genera un objeto PSCustomObject que representa la propiedad de elemento cuyo nombre ha cambiado. En caso contrario, este cmdlet no genera resultados.

Notas

El cmdlet Remove-ItemProperty está diseñado de modo que funcione con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.

Ejemplo 1

C:\PS>rename-itemproperty -path HKLM:\Software\SmpApplication -name config -newname oldconfig

Descripción
-----------
Este comando cambia el nombre de la entrada config del Registro contenida en la clave HKEY_LOCAL_MACHINE\Software\SmpApplication a oldconfig.

Vea también

Conceptos

about_Providers
Rename-Item
Clear-ItemProperty
Copy-ItemProperty
Get-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Set-ItemProperty