PowerShellコマンドレット虎の巻

Copy-ItemProperty

Copy-ItemPropertyは、アイテムプロパティをコピーするコマンドです。

エイリアスcpp

解説

アイテムのプロパティを別のアイテムにコピーします。
レジストリキーから別のレジストリキーにコピーする等で使用します。

構文

(構文)
Copy-ItemProperty [-Path] <string[]> [-Destination] <string> [-Name] <string> [<CommonParameters>] Copy-ItemProperty [-Destination] <string> [-Name] <string> [<CommonParameters>]
【主要パラメータ】
パラメータ説明
-Path パスコピー元のアイテムのパスを指定する
※必須パラメータ
-LiteralPath パス対象パスを指定する(ワイルドカード使用不可)
(例)-LiteralPath "D:\test"
-Name 名前コピーするプロパティの名前を指定する
複数のプロパティを指定することも可
(例)-Name "Property1"
-Destination パスコピー先のアイテムのパスを指定する
※必須パラメータ
-PassThruコピーされたプロパティのオブジェクトを出力する
-Force読み取り専用や既存のプロパティを上書きしてコピーする
-Filter フィルタコピーするプロパティをフィルタリングするための条件を指定する
(例)-Filter "Example*"
-Include 文字列指定した文字列を対象に含める
(ワイルドカード使用可)
(例)-Include *.log,*.tmp
 ⇒拡張子がlog、tmpのファイルを含める
-Exclude 文字列指定した文字列を対象から除外する
(ワイルドカード使用可)
(例)-Exclude Test*
 ⇒ファイルがTestで始まる物を除外する
-Credential 資格情報資格情報を指定する
-WhatIf実行はせずに実行結果の確認のみ行う
-Confirm実行前に確認メッセージの表示を行う
-UseTransactionトランザクションに参加する

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

サンプル

プロパティをコピーする

Copy-ItemProperty -Path "HKLM:\Software\SourceKey" -Name "Property1" -Destination "HKLM:\Software\DestinationKey"

複数のプロパティをコピーする

Copy-ItemProperty -Path "HKLM:\Software\SourceKey" -Name "Property1", "Property2" -Destination "HKLM:\Software\DestinationKey"

フィルターに一致するプロパティをコピーする

Copy-ItemProperty -Path "HKLM:\Software\SourceKey" -Name "ExampleProperty" -Destination "HKLM:\Software\DestinationKey" -Filter "Example*"

"Example"で始まるプロパティがコピーされます。

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

Get-Help Copy-ItemProperty

備考

  • PowerShellを管理者として実行する必要がある場合もあります。

関連項目