HOME > ItemProperty系コマンドレット > Rename-ItemProperty
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
備考
- レジストリの一部のキーや値にアクセスするには管理者権限が必要です。
関連項目
- ItemProperty系コマンドレット
- Clear-ItemProperty:アイテムプロパティの値のみをクリアする
- Copy-ItemProperty:アイテムプロパティをコピーする
- Get-ItemProperty:アイテムプロパティ情報を取得する
- Move-ItemProperty:アイテムプロパティを移動する
- New-ItemProperty:アイテムプロパティを新規作成する
- Rename-ItemProperty:アイテムプロパティ名を変更する
- Remove-ItemProperty:アイテムプロパティを削除する
- Set-ItemProperty:アイテムプロパティの値を設定する