PowerShell rename-item命令

PowerShell Rename-Item重命名PowerShell提供程序名称空间中的项目。它更改指定项目的名称。 它不影响被重命名的项目的内容。 ri，rm，rmdir，del，ease和rd是Rename-Item cmdlet的别名。

语法

语法1

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

语法2

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

参数

-Path - 此参数用于指定要重命名的项目的路径。
-LiteralPath - 此参数用于指定位置的路径。 它的值与键入时完全一样。 如果路径包含转义符，则将其用单引号引起来。单引号告诉Windows PowerShell，它不应将任何字符解释为转义序列。
-Force - 此参数用于强制执行命令而不要求用户确认。
-NewName - 此参数用于指定项目的新名称。 如果用户输入的路径与-Path参数中指定的路径不同，则此参数将产生错误。不能在-NewName参数的值中使用通配符。
-PassThru - 此参数返回一个对象，该对象表示正在使用的项目。 默认它不会产生任何输出。
-WhatIf - 此参数显示执行cmdlet将发生的情况。
-Confirm - 此参数在运行cmdlet之前提示确认。

示例

示例1： 重命名文件

PS D:\xntutor> rename-item readme.txt -newname new-readme.txt
PS D:\xntutor> dir


    目录: D:\xntutor


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2020/1/12     10:26           4144 html5.png
-a----        2020/1/12     10:35            294 index.html
-a----        2020/1/31     11:16             26 new-readme.txt

在此示例中，将文件readme.txt重命名为new-readme.txt。

示例2： 重命名多个文件

PS D:\xntutor> get-childitem


    目录: D:\xntutor


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2020/1/31     11:18                html
-a----        2020/1/31     11:16             26 file1.txt
-a----        2020/1/31     11:16             26 file2.txt
-a----        2020/1/31     11:20              0 index.html


PS D:\xntutor> get-childitem *.txt | rename-item -newname {$_.name -replace '.txt', '.doc'}
PS D:\xntutor> get-childitem


    目录: D:\xntutor


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2020/1/31     11:18                html
-a----        2020/1/31     11:16             26 file1.doc
-a----        2020/1/31     11:16             26 file2.doc
-a----        2020/1/31     11:20              0 index.html

在此示例中，将所有.txt文件重命名为.doc文件。

在此示例中，使用Get-ChildItem cmdlet来获取当前文件夹中所有扩展名为.txt的文件，然后将它们通过管道传递给Rename-Item。 -NewName指定的值是一个脚本块，会在值提交给-NewName参数之前运行。