Rename-ItemProperty
Cambia el nombre de una propiedad de un elemento.
Syntax
Rename-ItemProperty
[-Path] <String>
[-Name] <String>
[-NewName] <String>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Rename-ItemProperty
-LiteralPath <String>
[-Name] <String>
[-NewName] <String>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
El Rename-ItemProperty
cmdlet 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".
Rename-ItemProperty -Path HKLM:\Software\SmpApplication -Name config -NewName oldconfig
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
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 "User01" o "Domain01\User01", o escriba un objeto PSCredential , como uno generado por el Get-Credential
cmdlet.
Si escribe un nombre de usuario, se le pedirá una contraseña.
Advertencia
Este parámetro no es compatible con los proveedores instalados con Windows PowerShell.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Especifica los elementos que este cmdlet omite. El valor de este parámetro califica el parámetro Path. Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Especifica un filtro en el formato o idioma 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 cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
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 en función del proveedor. Para obtener más información, consulte about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Especifica solo los elementos en los que actúa el cmdlet, excepto todos los demás. El valor de este parámetro califica el parámetro Path. Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Especifica una ruta de acceso de la propiedad item. A diferencia del parámetro Path, el valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete caracteres como secuencias de escape.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica el nombre actual de la propiedad que se va a cambiar.
Type: | String |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
Especifica el nuevo nombre de la propiedad.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Devuelve un objeto que representa la propiedad item. De forma predeterminada, este cmdlet no genera ningún resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica la ruta de acceso del elemento cuyo nombre se va a cambiar. Se permite el uso de caracteres comodín.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-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, consulte about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Puede canalizar una cadena que contiene una ruta de acceso, pero no una ruta de acceso 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 resultados.
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.