パソコンで困ったとき、役立つ情報を公開（当サイトにはアフィリエイト広告を含む場合があります。リンクから商品を購入されると、運営者に報酬が発生することがあります。）

📝 はじめに

PowerShellで設定変更や環境調整を行っていると、
「レジストリの値を変更したい」
「既存の設定値を書き換えたい」
「GUIではなくスクリプトで設定を統一したい」
という場面はありませんか？

そんなときに使うのが
Set-ItemProperty です。
既存の項目（アイテム）が持つ値（プロパティ）を変更・設定するための重要なコマンドです。

✅ このコマンドでできること（要点）

✅ Set-ItemProperty でできること

Set-ItemProperty は、
指定したアイテムが持つ既存のプロパティ値を変更するコマンドです。

Get-ItemProperty が
「値を読む」ためのコマンドであるのに対し、
Set-ItemProperty は
「値を書き換える」役割を担います。

特にレジストリ操作で多用されます。

🧩 基本構文

Set-ItemProperty -Path パス -Name プロパティ名 -Value 設定値

変更対象のパスと、設定したいプロパティ名・値を指定します。

▶ 基本的な使い方（まずこれだけ）

🔹 レジストリの値を変更する

Set-ItemProperty HKCU:\Control Panel\Desktop -Name WallpaperStyle -Value "2"

指定したレジストリキーの
WallpaperStyle の値が変更されます。

🔹 数値の設定値を書き換える

Set-ItemProperty HKCU:\Software\MyApp -Name EnableFeature -Value 1

有効・無効などのフラグ設定に使われるケースです。

🛠 よく使われる指定例

🔹 変更前に現在の値を確認する

Get-ItemProperty HKCU:\Software\MyApp

事前に現在値を確認してから変更すると安全です。

🔹 変数を使って値を設定する

$value = 0
Set-ItemProperty HKCU:\Software\MyApp -Name EnableFeature -Value $value

条件分岐や設定切り替えに向いています。

💼 実務でよく使う使用例（応用）

🔹 設定値によって処理を切り替える

$current = (Get-ItemProperty HKCU:\Software\MyApp).EnableFeature
if ($current -ne 1) {
    Set-ItemProperty HKCU:\Software\MyApp -Name EnableFeature -Value 1
}

🔹 複数端末に同じ設定を適用する

$path = "HKCU:\Software\MyApp"
Set-ItemProperty $path -Name EnableFeature -Value 1
Set-ItemProperty $path -Name LogLevel -Value "Info"

🧩 よくある勘違い・つまずきポイント

• 存在しないプロパティは変更できない
• プロパティ名のスペルミスで失敗しやすい
• 管理者権限が必要なレジストリがある
• 値の型（文字列／数値）に注意が必要
• Get-ItemProperty と混同しやすい

🔄 cmdとの違いについて

cmd では reg add を使いますが、
PowerShell の Set-ItemProperty は
値をオブジェクトとして扱えるため、
条件付き処理や再利用がしやすいのが特徴です。

⚠ エラー・うまく動かないときの確認ポイント

🧠 注意点

Set-ItemProperty は
システムやアプリの挙動に直接影響を与える操作です。
実務では必ず
事前確認・バックアップ・テストを行ったうえで
実行するようにしましょう。

📌 まとめ

• Set-ItemProperty は項目の値を変更するコマンド
• 主にレジストリ設定で使われる
• Get-ItemProperty とセットで理解する
• 自動化・一括設定に非常に有効

🔎 PowerShellコマンドを探す

やりたいことからコマンドを探すこともできます。

• レジストリの値を変更したい
• 設定をスクリプトで適用したい
• 既存の設定値を書き換えたい
• 環境設定を自動化したい
• エラーや実行できない原因を調べたい
• PowerShellで設定管理したい
• 安全に設定変更したい