Rename-Item 帮助信息

  如下说明是翻译 : help Rename-Item 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Rename-Item

 

大纲

重命名 Windows PowerShell 提供程序名字空间中的一个项目 .

 

语法

Rename-Item [-path] <string> [-newName] <string> [-force] [-passThru] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

重命名 Windows PowerShell 提供程序 (Provider) 名字空间中的一个项目 . 使用此命令不会影响改名对象的内容 .

 

参数

 

-path <string>

指定要重命名项目的路径 .

 

强制参数 ?	true
参数位置 ?	1
默认值	< 当前位置 >
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	true

 

-newName <string>

指定项目的新名称 .

 

强制参数 ?	true
参数位置 ?	2
默认值	N/A - 必须指定路径名
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

-force <SwitchParameter>

在不破坏安全前提下 , 能够避免影响命令成功执行的限制条件 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-passThru <SwitchParameter>

输出此命令创建的对象到管道中 . 默认情况下 , 此命令不会将对象输出到管道 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-credential <PSCredential>

凭证被用来验证访问权限 . 如果指定了一个之前使用 Get-Credential 获得的 PSCredential 对象 , 将会直接使用该对象 . 如果此处使用用户名 , 命令执行时会提示输入该用户密码 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

字符串

 

注意

 

更多信息 , 输入 "Get-Help Rename-Item  -detailed". 需要技术信息 , 输入 "Get-Help Rename-Item -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>rename-item -path c:/logfiles/daily_file.txt -newname monday_file.txt

 

此命令将文件 daily_file.txt 重命名为 monday_file.txt.

 

相关链接

Clear-Item

Invoke-Item

Move-Item

Set-Item

New-Item

Remove-Item

Get-Item

Copy-Item

about_namespace