PowerShell Rename-Item | PowerShell 重命名文件

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

语法

参数

-Path

-Path 参数用于指定要重命名的项目的路径。

-LiteralPath

-LiteralPath 参数用于指定一个或多个位置的路径。 它的值将按原样使用。如果路径包含转义字符，请将其用单引号括起来。 单引号告诉 Windows PowerShell 不应将任何字符解释为转义序列。 在该 cmdlet 中，没有任何字符被解释为通配符。

-NewName

-NewName 参数用于指定项目的的新名称。如果用户输入的路径与 -Path 参数中指定的路径不同，则此参数会生成错误。 我们不能在 -NewName 参数的值中使用通配符。

-Force

-Force 参数强制 cmdlet 重命名那些无法更改的项目，例如隐藏文件、只读文件、别名或变量。它不能**删除**常量变量或别名。即使使用 -Force 参数，cmdlet 也无法覆盖安全权限。

-PassThru

-PassThru 参数返回一个对象，该对象表示管道中的一个项目。默认情况下，它不会生成任何输出。

-WhatIf

-WhatIf 参数显示如果运行 cmdlet 会发生什么情况。该 cmdlet 不会执行。

-Confirm

-Confirm 参数在运行 cmdlet 之前提示确认。

示例

示例 1：重命名文件

在此示例中，cmdlet 将当前目录中的文件 s.txt 重命名为 c.txt。

示例 2：重命名多个文件

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

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