Rename-Item

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

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

Командлет Rename-Item изменяет имя указанного элемента. Этот командлет не влияет на содержимое переименоваемого элемента.

Невозможно использовать Rename-Item для перемещения элемента, например путем указания пути вместе с новым именем. Чтобы переместить и переименовать элемент, используйте командлет Move-Item.

Эта команда переименовывает файл daily_file.txt в monday_file.txt.

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

Нельзя использовать Rename-Item для переименования и перемещения элемента. В частности, нельзя указать путь для значения параметра NewName, если путь не идентичен пути, указанному в параметре пути. В противном случае разрешено только новое имя.

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"

В этом примере выполняется попытка переименовать файл project.txt в текущем каталоге в old-project.txt в каталоге D:\Archive. Результатом является ошибка, показанная в выходных данных.

Вместо этого используйте командлет Move-Item.

В этом примере раздел реестра переименовывается из Рекламы в Маркетинг. По завершении команды ключ переименовывается, но записи реестра в ключе остаются без изменений.

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

В этом примере все файлы *.txt в текущем каталоге переименовывается в *.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

Командлет Get-ChildItem находит все файлы в текущей папке с расширением файла .txt, а затем отправляет их в Rename-Item. Значение NewName — это блок скрипта, который выполняется перед отправкой значения в параметр NewName.

В блоке скрипта $_ автоматическая переменная представляет каждый файловый объект по мере выполнения команды через конвейер. Блок скрипта использует оператор -replace для замены расширения каждого файла на .log. Обратите внимание, что сопоставление с использованием оператора -replace не учитывает регистр.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать строку, содержащую путь к этому командлету.

По умолчанию этот командлет не возвращает выходные данные.

При использовании параметра PassThru этот командлет возвращает объект, представляющий переименованный элемент.

PowerShell включает следующие псевдонимы для Rename-Item:

• Все платформы:
  • ren
  • rni

Rename-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе о поставщиках.