PowerShellコマンドレット虎の巻

Rename-ItemProperty

Rename-ItemPropertyは、アイテムプロパティ名を変更するコマンドです。

エイリアスrnp

解説

指定されたアイテムのプロパティ名を変更します。
特にレジストリキーのプロパティ名を変更する際に使用されます。

構文

(構文)
Rename-ItemProperty [-Path] <string> [-Name] <string> [-NewName] <string> [<CommonParameters>] Rename-ItemProperty [-Name] <string> [-NewName] <string> [<CommonParameters>]
【主要パラメータ】
パラメータ説明
-Path パスプロパティ名を変更するアイテムのパスを指定する
※必須パラメータ
(例)-Path "HKLM:\Software\MyCompany\MyApp"
-LiteralPath パス対象パスを指定する(ワイルドカード使用不可)
(例)-LiteralPath "D:\test"
-Name プロパティ名現在のプロパティ名を指定する
※必須パラメータ
(例)-Name "OldPropertyName"
-NewName プロパティ名新しいプロパティ名を指定する
※必須パラメータ
(例)-NewName "NewPropertyName"
-PassThru変更されたプロパティのオブジェクトを出力する
-Force読み取り専用のプロパティ名を変更する
-Include 文字列指定した文字列を対象に含める
(ワイルドカード使用可)
(例)-Include *.log,*.tmp
 ⇒拡張子がlog、tmpのファイルを含める
-Exclude 文字列指定した文字列を対象から除外する
(ワイルドカード使用可)
(例)-Exclude Test*
 ⇒ファイルがTestで始まる物を除外する
-Credential 資格情報資格情報を指定する
-WhatIf実行はせずに実行結果の確認のみ行う
-Confirm実行前に確認メッセージの表示を行う
-UseTransactionトランザクションに参加する

共通的なパラメータは「共通パラメータ」をご覧ください。

サンプル

レジストリキーのプロパティ名を変更する

Rename-ItemProperty -Path "HKLM:\Software\MyCompany\MyApp" -Name "OldPropertyName" -NewName "NewPropertyName"

パイプラインを使用してレジストリキーのプロパティ名を変更する

Get-ItemProperty -Path "HKLM:\Software\MyCompany\MyApp" -Name "OldPropertyName" | Rename-ItemProperty -NewName "NewPropertyName"

コマンドのヘルプを表示する

Get-Help Rename-ItemProperty

備考

  • レジストリの一部のキーや値にアクセスするには管理者権限が必要です。

関連項目