当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 重命名项目属性 (Microsoft.PowerShell.Management)

作者:精品下载站 日期:2024-12-14 02:11:17 浏览:13 分类:玩电脑

重命名项目属性 (Microsoft.PowerShell.Management)


Rename-ItemProperty

模块 :Microsoft.PowerShell.Management

重命名项目的属性。

句法

Rename-ItemProperty
      [-Path] <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-ItemProperty
      -LiteralPath <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

描述

Rename-ItemProperty cmdlet 可更改指定项属性的名称。财产的价值没有改变。例如,您可以使用 Rename-ItemProperty 更改注册表项的名称。

示例

示例 1:重命名注册表项

此命令将 HKEY_LOCAL_MACHINE\Software\SmpApplication 项中包含的配置注册表项重命名为“oldconfig”。

Rename-ItemProperty -Path HKLM:\Software\SmpApplication -Name config -NewName oldconfig

参数

-Confirm

在运行 cmdlet 之前提示您进行确认。

类型 :

SwitchParameter

别名:

cf

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Credential

笔记

随 PowerShell 安装的任何提供程序均不支持此参数。要在运行此 cmdlet 时模拟其他用户或提升您的凭据,请使用 Invoke-Command。

类型 :

PS凭证

位置:

命名

默认值:

当前用户

必需的:

False

接受管道输入:

True

接受通配符:

False

-Exclude

以字符串数组形式指定此 cmdlet 在操作中排除的一个或多个项目。此参数的值限定 Path 参数。输入路径元素或模式,例如 *.txt。允许使用通配符。仅当命令包含某个项目的内容时,排除参数才有效,例如C:\Windows\*,其中通配符指定的内容>C:\Windows 目录。

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-Filter

指定一个过滤器来限定 Path 参数。文件系统提供程序是唯一安装的支持使用筛选器的 PowerShell 提供程序。您可以在 about_Wildcards 中找到文件系统过滤器语言的语法。过滤器比其他参数更有效,因为提供程序在 cmdlet 获取对象时应用它们,而不是让 PowerShell 在检索对象后过滤对象。

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-Force

强制 cmdlet 重命名用户无法访问的对象的属性。实施方式因提供商而异。有关详细信息,请参阅 about_Providers。

类型 :

SwitchParameter

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Include

以字符串数组形式指定此 cmdlet 在操作中包含的一个或多个项目。此参数的值限定 Path 参数。输入路径元素或模式,例如 "*.txt"。允许使用通配符。仅当命令包含某个项目的内容时,Include 参数才有效,例如 C:\Windows\*,其中通配符指定 的内容>C:\Windows 目录。

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-LiteralPath

指定项目的路径。 LiteralPath 的值完全按照键入的方式使用。没有字符被解释为通配符。如果路径包含转义字符,请将其用单引号引起来。单引号告诉 PowerShell 不要将任何字符解释为转义序列。

有关更多信息,请参阅 about_Quoting_Rules。

类型 :

String

别名:

PSPath, LP

位置:

命名

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-Name

指定要重命名的属性的当前名称。

类型 :

String

别名:

PSProperty

位置:

1

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-NewName

指定属性的新名称。

类型 :

String

位置:

2

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-PassThru

返回表示项目属性的对象。默认情况下,此 cmdlet 不生成任何输出。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Path

指定项目的路径。允许使用通配符。

类型 :

String

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

True

-WhatIf

显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

字符串

您可以通过管道将包含路径(但不是文字路径)的字符串传递到此 cmdlet。

输出

默认情况下,此 cmdlet 不返回任何输出。

PS自定义对象

当您使用 PassThru 参数时,此 cmdlet 将返回表示重命名的项属性的 PSCustomObject

笔记

PowerShell 包含以下 Rename-ItemProperty 别名:

  • 所有平台:

      rnp

    Rename-ItemProperty 旨在处理任何提供程序公开的数据。要列出会话中可用的提供程序,请输入 Get-PSProvider。有关详细信息,请参阅 about_Providers。

    您需要 登录账户 后才能发表评论

    取消回复欢迎 发表评论:

    关灯