もくじ
📝 はじめに
PowerShellでレジストリを操作していると、
「キー自体が存在しないため値を作成できない」
「アプリ用のレジストリキーを新しく用意したい」
といった場面に出会うことがあります。
そんなときに使うのが
New-Item を使ったレジストリキーの作成です。
この記事では、レジストリキー(フォルダに相当する部分)を新規作成する基本として、
Registry操作に絞って分かりやすく解説します。
- アプリ用のレジストリキーを新規作成したい
- 初期設定スクリプトでキーを準備したい
- 値を作成する前に入れ物(キー)を用意したい
✅ このコマンドでできること(要点)
- レジストリキーを新規作成できる
- HKCU / HKLM などの配下にキーを追加できる
- スクリプトで初期構造を自動生成できる
- 値作成(New-ItemProperty)の前準備に使える
✅ New-Item(Registry)でできること
New-Item は、
ファイルやフォルダを作成するコマンドですが、
PowerShellではレジストリキーも「アイテム」として扱えます。
レジストリでは、
「キー=フォルダ」
「値=中に入る設定」
という関係になります。
考え方としては、
「設定を入れるためのフォルダを作る」イメージです。
🧩 基本構文
New-Item -Path レジストリパス -Name キー名
指定したパス配下に、
新しいレジストリキーが作成されます。
▶ 基本的な使い方(まずこれだけ)
🔹 レジストリキーを新規作成する
New-Item -Path HKCU:\Software -Name TestApp
エラーが表示されなければ、
HKCU:\Software\TestApp というキーが作成されています。
この結果が出ていれば、基本操作は問題ありません。
🔹 フルパスで作成する
New-Item -Path HKCU:\Software\TestApp\Settings
親キーが存在していれば、
指定したパスのキーが作成されます。
🛠 よく使われる指定例
🔹 既存キーがあってもエラーにしない
New-Item -Path HKCU:\Software\TestApp -Force
-Force を指定すると、
すでにキーが存在していてもエラーになりません。
初期化スクリプトでよく使われます。
🔹 作成結果を確認する
Get-ChildItem HKCU:\Software
作成したキー名が表示されていれば、
正しく作成されています。
💼 実務でよく使う使用例(応用)
🔹 値作成と組み合わせる
$path = "HKCU:\Software\TestApp"
New-Item -Path $path -Force
New-ItemProperty -Path $path -Name Enabled -Value 1 -PropertyType DWORD
🔹 複数キーをまとめて準備する
$base = "HKCU:\Software\TestApp"
New-Item -Path "$base\Settings" -Force
New-Item -Path "$base\Logs" -Force
- Test-Path で存在チェック
- New-ItemProperty で値を作成
- Remove-Item で不要キーを削除
🧩 よくある勘違い・つまずきポイント
- 値は New-Item では作成できない
- HKLM 配下は管理者権限が必要になることが多い
- 親キーが存在しないと作成できない場合がある
- -Force を付けないとエラーになることがある
- 誤った場所にキーを作成してしまう
🔄 cmdとの違いについて
cmd では reg add を使って
キーを作成しますが、
PowerShellではキーと値を役割ごとに分けて操作できます。
構造が分かりやすく、
スクリプト管理しやすい点が特徴です。
⚠ エラー・うまく動かないときの確認ポイント
- 指定したレジストリパスが正しいか
- 管理者権限が必要な場所ではないか
- 親キーが存在しているか
- すでに同名のキーが存在していないか
🧠 注意点
レジストリキーの作成自体は安全ですが、
作成場所を誤るとアプリやOSの挙動に影響する可能性があります。
実務では、仕様に基づいたキーのみ作成するようにしてください。
📌 まとめ
- New-Item でレジストリキーを作成できる
- キーは値を入れるための入れ物
- 値作成は New-ItemProperty を使う
- 初期設定スクリプトでは -Force が便利
🔎 PowerShellコマンドを探す
やりたいことからPowerShellコマンドを探せます。
- ファイルを削除したい
- 一覧を表示したい
- 文字列を検索したい
- 条件で絞り込みたい
- エラーや実行できない原因を調べたい
- レジストリキーを作成したい
- 初期設定を自動化したい
