Compartir a través de

Rename-Item

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Cambia el nombre de un elemento en un espacio de nombres del proveedor de PowerShell.

Sintaxis

Rename-Item
      [-Path] <String>
      [-NewName] <String>
      [-Force]
      [-PassThru]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm] 
      [<CommonParameters>]
Rename-Item
      -LiteralPath <String>
      [-NewName] <String>
      [-Force]
      [-PassThru]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm] 
      [<CommonParameters>]

Description

El cmdlet Rename-Item cambia el nombre de un elemento especificado. Este cmdlet no afecta al contenido del elemento al que se va a cambiar el nombre.

No puede usar Rename-Item para mover un elemento, por ejemplo, especificando una ruta de acceso junto con el nuevo nombre. Para mover y cambiar el nombre de un elemento, use el cmdlet Move-Item.

Ejemplos

Ejemplo 1: Cambiar el nombre de un archivo

Este comando cambia el nombre del archivo daily_file.txt a monday_file.txt.

Rename-Item -Path "c:\logfiles\daily_file.txt" -NewName "monday_file.txt"

Ejemplo 2: Cambiar el nombre y mover un elemento

No puede usar Rename-Item para cambiar el nombre y mover un elemento. En concreto, no se puede proporcionar una ruta de acceso para el valor del parámetro NewName, a menos que la ruta de acceso sea idéntica a la ruta especificada en el parámetro Path de. De lo contrario, solo se permite un nuevo nombre.

Rename-Item -Path "project.txt" -NewName "d:\archive\old-project.txt"

Rename-Item : can't rename because the target specified represents a path or device name.
At line:1 char:12
+ Rename-Item <<<<  -path project.txt -NewName d:\archive\old-project.txt
+ CategoryInfo          : InvalidArgument: (:) [Rename-Item], PS>  Move-Item -Path "project.txt" -De
stination "d:\archive\old-project.txt"

En este ejemplo se intenta cambiar el nombre del archivo project.txt del directorio actual a old-project.txt en el directorio D:\Archive. El resultado es el error que se muestra en la salida.

Use el cmdlet Move-Item en su lugar.

Ejemplo 3: Cambiar el nombre de una clave del Registro

En este ejemplo se cambia el nombre de una clave del Registro de Advertising a Marketing. Una vez completado el comando, se cambia el nombre de la clave, pero las entradas del Registro de la clave no cambian.

Rename-Item -Path "HKLM:\Software\MyCompany\Advertising" -NewName "Marketing"

Ejemplo 4: Cambiar el nombre de varios archivos

En este ejemplo se cambia el nombre de todos los archivos de *.txt del directorio actual a *.log.

Get-ChildItem *.txt

Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.TXT
-a----        10/3/2019   7:46 AM           2918 Monday.Txt
-a----        10/3/2019   7:47 AM           2918 Wednesday.txt

Get-ChildItem *.txt | Rename-Item -NewName { $_.Name -replace '.txt','.log' }
Get-ChildItem *.log

Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.log
-a----        10/3/2019   7:46 AM           2918 Monday.log
-a----        10/3/2019   7:47 AM           2918 Wednesday.log

El cmdlet Get-ChildItem obtiene todos los archivos de la carpeta actual que tienen una extensión de archivo .txt y, a continuación, los canaliza a Rename-Item. El valor de NewName es un bloque de script que se ejecuta antes de enviar el valor al parámetro NewName.

En el bloque de script, el $_ variable automática representa cada objeto de archivo a medida que se trata del comando a través de la canalización. El bloque de script usa el operador -replace para reemplazar la extensión de archivo de cada archivo por .log. Observe que la coincidencia con el operador -replace no distingue mayúsculas de minúsculas.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Nota

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.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Force

Obliga al cmdlet a cambiar el nombre de los elementos que, de lo contrario, no se pueden cambiar, como archivos ocultos o de solo lectura o alias o variables de solo lectura. El cmdlet no puede cambiar alias o variables constantes. La implementación varía de proveedor a proveedor. Para obtener más información, consulte about_Providers.

Incluso con el parámetro Force , el cmdlet no puede invalidar las restricciones de seguridad.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. 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.

Para obtener más información, consulte sobre_las_normas_de_citación.

Tipo:String
Alias:PSPath, LP
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NewName

Especifica el nuevo nombre del elemento. Escriba solo un nombre, no una ruta de acceso y un nombre. Si escribe una ruta de acceso que difiere de la ruta de acceso especificada en el parámetro Path de, Rename-Item genera un error. Para cambiar el nombre y mover un elemento, use Move-Item.

No puede usar caracteres comodín en el valor del parámetro NewName. Para especificar un nombre para varios archivos, use el operador Replace en una expresión regular. Para obtener más información sobre el operador Replace, vea about_Comparison_Operators.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento a la canalización. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso del elemento al que se va a cambiar el nombre.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga una ruta a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

PSObject

Cuando se usa el parámetro PassThru, este cmdlet devuelve un objeto que representa el elemento cuyo nombre ha cambiado.

Notas

PowerShell incluye los siguientes alias para Rename-Item:

  • Todas las plataformas:
    • ren
    • rni

Rename-Item 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.