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
Descrição
-----------
Esse comando renomeia o arquivo daily_file.txt para 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
Descrição
-----------
Este exemplo mostra que você não pode usar o cmdlet Rename-Item para renomear e mover um item. Especificamente, não é possível fornecer um caminho para o valor do parâmetro NewName, a menos que o caminho seja idêntico àquele especificado no parâmetro Path. Caso contrário, somente um novo nome será permitido.
O primeiro comando usa o cmdlet Rename-Item para renomear o arquivo project.txt no diretório atual como old-project.txt no diretório D:\Archive. O resultado é o erro mostrado na saída.
O segundo comando mostra a maneira correta de mover e renomear um arquivo usando o cmdlet Move-Item. O cmdlet Move-Item permite especificar um novo caminho e um novo nome no valor do parâmetro Destination.

C:\PS>rename-item HKLM:\Software\MyCompany\Advertising -NewName Marketing
Descrição
-----------
Esse comando usa o cmdlet Rename-Item para renomear uma chave do Registro de Advertising para Marketing. Quando o comando for concluído, a chave estará renomeada, mas as entradas do Registro na chave estarão inalteradas.

C:\PS>get-childItem *.txt | rename-item -newname { $_.name -replace '\.txt','.log' }
Descrição
-----------
Este exemplo mostra como usar o operador Replace para renomear vários arquivos, embora o parâmetro NewName não aceite caracteres curinga.
Esse comando renomeia todos os arquivos .txt do diretório atual como .log. 
O comando usa um cmdlet Get-ChildItem para obter todos os arquivos no diretório atual que têm uma extensão de nome de arquivo .txt. Em seguida, ele usa o operador de pipeline (|) para enviar os arquivos resultantes para o cmdlet Rename-Item. 
No comando Rename-Item, o valor do parâmetro NewName é um bloco de scripts executado antes que o valor seja enviado para o parâmetro NewName.
No bloco de scripts, a variável automática $_ representa cada objeto de arquivo conforme chega no comando por meio do pipeline. O comando usa o formato de ponto (.) para obter a propriedade Name de cada objeto de arquivo. O operador Replace substitui a extensão de nome de arquivo ".txt" de cada arquivo por ".log".
Como o operador Replace funciona com expressões regulares, o ponto antes de "txt" é interpretado como uma correspondência a qualquer caractere. Para garantir que ele corresponda somente a um ponto (.), usa-se o caractere de escape de barra invertida (\). O caractere de barra invertida não é exigido em ".log" porque é uma string, não uma expressão regular.