PowerShell Rename-Item| PowerShell重命名文件

本文概述

• 句法
• 参数
• 例子

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

句法

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

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

参数

-路径

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

文学路径

-LiteralPath参数用于指定一个或多个位置的路径。它的值与键入时完全一样。如果路径包含转义符, 则将其用单引号引起来。单引号告诉Windows PowerShell, 它不应将任何字符解释为转义序列。 cmdlet中没有字符, 该字符被解释为通配符。

-新名字

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

-力

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

直通

-PassThru参数将代表对象的对象返回到管道。默认情况下, 它不生成任何输出。

-如果

-WhatIf参数显示如果cmdlet运行将发生的情况。该cmdlet不执行。

-确认

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

例子

示例1：重命名文件

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

示例2：重命名多个文件

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

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