Rename-Item

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

C:\PS>rename-item -path c:\logfiles\daily_file.txt -newname monday_file.txt

Descripción
-----------
Este comando cambia el nombre del archivo daily_file.txt a monday_file.txt.

C:\PS>rename-item -path project.txt -newname d:\archive\old-project.txt

Rename-Item : Cannot 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], PSArgumentException
    + FullyQualifiedErrorId : Argument,Microsoft.PowerShell.Commands.RenameItemCommand


C:\PS> move-item -path project.txt -destination d:\archive\old-project.txt
# Command succeeds

Descripción
-----------
En este ejemplo, se muestra que no se puede utilizar el cmdlet Rename-Item para cambiar de nombre y mover un elemento. Concretamente, no se puede proporcionar una ruta de acceso para el valor del parámetro NewName, a menos que sea idéntica a la ruta de acceso especificada en el parámetro Path. De lo contrario, solo se permite un nuevo nombre.

El primer comando utiliza el cmdlet Rename-Item para cambiar el nombre del archivo project.txt en el directorio actual a old-project.txt en el directorio D:\Archive. El resultado es el error que se muestra en la salida.

El segundo comando muestra la forma correcta de mover y cambiar el nombre de un archivo utilizando el cmdlet Move-Item. El cmdlet Move-Item permite especificar una nueva ruta de acceso y un nuevo nombre en el valor de su parámetro Destination.

C:\PS>rename-item HKLM:\Software\MyCompany\Advertising -NewName Marketing

Descripción
-----------
Este comando utiliza el cmdlet Rename-Item para cambiar el nombre de una clave del Registro de Advertising a Marketing. Cuando el comando se completa, se cambia el nombre de la clave, pero las entradas del Registro en la clave permanecen inalteradas.

C:\PS>get-childItem *.txt | rename-item -newname { $_.name -replace '\.txt','.log' }

Descripción
-----------
En este ejemplo se muestra la forma de utilizar el operador Replace para cambiar el nombre de varios archivos, aunque el parámetro NewName no acepte caracteres comodín.

Este comando cambia el nombre de los archivos .txt del directorio actual a .log. 

El comando utiliza un cmdlet Get-ChildItem para obtener todos los archivos del directorio actual que tienen una extensión de nombre de archivo .txt. A continuación, utiliza el operador de canalización (|) para enviar los archivos resultantes al cmdlet Rename-Item. 

En el comando Rename-Item, el valor del parámetro NewName es un bloque de script que se ejecuta antes de que se envíe el valor al parámetro NewName.

En el bloque de script, la variable automática $_ representa cada objeto de archivo que llega al comando a través de la canalización. El comando usa el formato con punto (.) para obtener la propiedad Name de cada objeto de archivo. El operador Replace reemplaza la extensión de nombre de archivo ".txt" de cada archivo por ".log".

Dado que el operador Replace funciona con expresiones regulares, el punto que precede a "txt" se interpreta como equivalente a cualquier carácter. Para garantizar la equivalencia solo con un punto (.), se utiliza una barra diagonal inversa como carácter de escape (\). La barra diagonal inversa no se requiere en ".log" porque es una cadena y no una expresión regular.