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
参数之前运行。