はい、承知いたしました。PowerShellのRename-Itemコマンドレットの使い方に関する詳細なガイド記事を、約5000語で記述します。記事の内容を直接ここに表示します。

PowerShell Rename-Itemコマンドの使い方完全ガイド

はじめに：なぜRename-Itemを学ぶのか？

ファイルやフォルダの名前を変更する操作は、コンピュータを使う上で最も基本的な操作の一つです。エクスプローラーなどのGUIツールを使えば簡単にできますが、手作業では時間がかかる、大量のファイルを一括で処理したい、特定のルールに基づいて名前を変更したい、といった場合にGUIツールだけでは対応できません。

ここでPowerShellのRename-Itemコマンドレットの出番です。Rename-Itemは、PowerShellの強力な自動化能力を活用して、ファイルやフォルダだけでなく、レジストリキー、変数、エイリアス、関数といった様々な「アイテム」の名前をプログラム的に変更することを可能にします。これは、システム管理、データ整理、スクリプト開発など、幅広いシナリオで非常に役立ちます。

このガイドでは、Rename-Itemの最も基本的な使い方から、パイプライン、スクリプトブロック、変数などを組み合わせた高度なテクニックまで、網羅的に解説します。これを読めば、Rename-Itemを完全にマスターし、日常のタスクを効率化できるようになるでしょう。

Rename-Itemの基本構文

Rename-Itemコマンドレットの基本的な構文は非常にシンプルです。

powershell Rename-Item -Path <変更したいアイテムのパス> -NewName <新しい名前>

-Path: 名前を変更したいアイテム（ファイル、フォルダなど）のパスを指定します。絶対パスでも相対パスでも構いません。ワイルドカードは使用できません（複数のアイテムを処理する方法は後述します）。このパラメーターには -LiteralPath というエイリアスもありますが、基本的な挙動は同じです。ただし、-LiteralPathを使う場合は、ワイルドカードや特殊文字が文字どおりに解釈されます。通常は-Pathで問題ありません。
-NewName: アイテムに付けたい新しい名前を指定します。ファイルの場合、拡張子を含めた完全な名前を指定する必要があります。フォルダの場合は、フォルダ名だけを指定します。

例1：単一のファイルの名前を変更する

ドキュメントフォルダにある「old_file.txt」というファイルを「new_file.txt」に名前変更したい場合、以下のコマンドを実行します。

powershell Rename-Item -Path "$HOME\Documents\old_file.txt" -NewName "new_file.txt"

$HOMEは、現在のユーザーのホームディレクトリを示すPowerShellの自動変数です。

例2：単一のフォルダの名前を変更する

デスクトップにある「old_folder」というフォルダを「new_folder」に名前変更したい場合、以下のコマンドを実行します。

powershell Rename-Item -Path "$HOME\Desktop\old_folder" -NewName "new_folder"

例3：相対パスを使用する

カレントディレクトリ（現在の場所）に「report.docx」というファイルがある場合、相対パスを使って名前を変更することもできます。

“`powershell

現在の場所が report.docx があるフォルダの場合

Rename-Item -Path “report.docx” -NewName “final_report.docx”
“`

カレントディレクトリを確認するにはGet-Locationコマンドレットを使用します。

Rename-Itemの主要パラメーターの詳細

Rename-Itemには、基本的な-Pathと-NewName以外にも、操作をより細かく制御するための便利なパラメーターが多数あります。

`-Path` および `-LiteralPath`

役割: 名前を変更する対象のアイテムを指定します。
詳細: ほとんどの場合、-Pathを使用します。パスにスペースが含まれる場合は、パス全体を引用符（"または'）で囲む必要があります。
powershell Rename-Item -Path "C:\My Folder\my document.txt" -NewName "my new document.txt"
-LiteralPath: パス文字列中のワイルドカードや特殊文字を文字通りに扱いたい場合に使用します。例えば、ファイル名に [ ] や * が含まれている場合などに役立ちます。
powershell # 名前が "report[final].txt" のファイルがある場合 Rename-Item -LiteralPath ".\report[final].txt" -NewName "final_report.txt" # -Path を使うとエラーになるか、意図しない挙動になる可能性があります # Rename-Item -Path ".\report[final].txt" -NewName "final_report.txt" # これはワイルドカードとして解釈される可能性がある
ただし、-LiteralPathはワイルドカードを文字通りに扱うだけであり、-Pathのようにワイルドカードで複数のアイテムを指定することはできません。あくまで単一のアイテムを指定する際に、パス文字列中の特殊文字をエスケープせずにそのまま渡したい場合に使います。

`-NewName`

役割: アイテムの新しい名前を指定します。
詳細: 新しい名前を文字列で指定します。ファイルの場合、拡張子を含める必要があることに注意してください。拡張子を省略すると、拡張子がない名前になります。
powershell Rename-Item -Path "document.txt" -NewName "document" # 拡張子がなくなる
新しい名前には、ファイルシステムが許可する文字のみを使用できます。Windowsでは通常、\ / : * ? " < > | といった文字はファイル名やフォルダ名に使用できません。
-NewNameパラメーターは、後述するパイプラインと組み合わせる際に、スクリプトブロック {} を受け取ることができます。これは、パイプラインから渡されたアイテムごとに動的に新しい名前を生成する場合に非常に強力です。

`-ItemType`

役割: 名前を変更するアイテムの種類（ファイル、ディレクトリなど）を指定します。
詳細: 通常、PowerShellはパスからアイテムの種類を自動的に判断します。しかし、同じ名前のファイルとフォルダが同じ場所に存在する場合など、曖昧さがある場合に種類を明示的に指定できます。
powershell # 仮に、カレントディレクトリに "data" という名前のファイルと "data" という名前のフォルダがあるとする # ファイルの名前を変更したい場合 Rename-Item -Path ".\data" -NewName "data_file" -ItemType File # フォルダの名前を変更したい場合 Rename-Item -Path ".\data" -NewName "data_folder" -ItemType Directory
-ItemTypeで指定できる値は、使用しているPowerShellプロバイダーによって異なります。ファイルシステムプロバイダーではFileとDirectoryが一般的です。

`-Force`

役割: 通常の制限を無視して操作を実行します。
詳細: 通常、Rename-Itemは、読み取り専用ファイルの名前を変更しようとしたり、隠しファイルの名前を変更しようとしたりする際にエラーになることがあります。-Forceを使用すると、これらの制限を無視して名前の変更を試みます。ただし、権限がない場合など、物理的に不可能な操作は-Forceを使っても実行できません。
powershell # 読み取り専用ファイルを強制的に名前変更 Rename-Item -Path "readonly.txt" -NewName "writable.txt" -Force
-Forceの使用は注意が必要です。予期しない結果を招く可能性があるため、本当に必要な場合にのみ使用してください。

`-WhatIf`

役割: コマンドを実行した場合に何が起こるかを表示しますが、実際には何も変更しません。
詳細: これは非常に便利な安全機能です。特に、複数のアイテムを処理する複雑なリネーム操作を実行する前に、意図したとおりに動作するかどうかを確認するために使用します。
powershell # このコマンドを実行した場合に何が起こるか確認 Rename-Item -Path "old_file.txt" -NewName "new_file.txt" -WhatIf
実行すると、以下のような出力が表示されます（実際にはファイルは変更されません）。
What if: Performing the operation "Rename Item" on Target "Item: C:\path\to\old_file.txt Destination: C:\path\to\new_file.txt".
複雑なスクリプトやバッチ処理を行う前には、必ず-WhatIfを使ってテストすることをおすすめします。

`-Confirm`

役割: 操作を実行する前に確認メッセージを表示します。
詳細: コマンドを実行すると、アイテムごとに「この操作を実行しますか？」というプロンプトが表示され、ユーザーがY（はい）、N（いいえ）、A（すべてはい）、L（すべていいえ）、S（中断）、?（ヘルプ）の中から選択する必要があります。
powershell # 名前変更の前に確認プロンプトを表示 Rename-Item -Path "sensitive_file.txt" -NewName "less_sensitive_file.txt" -Confirm
-Confirmも安全機能として役立ちますが、大量のアイテムを処理する際にはプロンプトが何度も表示されるため、実用的ではない場合があります。その場合は-WhatIfの方が適しています。

`-PassThru`

役割: 名前が変更されたアイテムのオブジェクトをパイプラインに出力します。
詳細: 通常、Rename-Itemは何も出力を表示しません。-PassThruを使用すると、名前が変更された後の新しいアイテムを表すオブジェクトがコマンドレットから出力されます。このオブジェクトをパイプラインで別のコマンドレットに渡すことができます。
powershell # 名前変更後のアイテム情報を表示 Rename-Item -Path "file_to_rename.txt" -NewName "renamed_file.txt" -PassThru
実行すると、新しいファイルの名前、パス、サイズ、更新日時などの情報が表示されます。
この機能は、名前変更後にそのアイテムに対して別の操作（例：新しい名前のファイルを別の場所に移動するなど）を続けたい場合に便利です。

複数のアイテムの名前を変更する

Rename-Itemコマンドレットは、-Pathパラメーターで複数のパスを直接指定することはできません（ワイルドカードも基本的には非対応）。しかし、PowerShellのパイプラインと他のコマンドレットを組み合わせることで、簡単に複数のファイルやフォルダの名前を一括で変更できます。

最も一般的な方法は、Get-ChildItemで対象のアイテムを取得し、それをForEach-Objectコマンドレットにパイプして、各アイテムに対してRename-Itemを実行する方法です。

例4：特定の拡張子を持つファイルの名前を一括変更する

カレントディレクトリにある全ての.txtファイルの拡張子を.logに変更したいとします。

powershell Get-ChildItem -Path ".\*.txt" | ForEach-Object { # $_ はパイプラインから渡されてきた現在のアイテムオブジェクト $newName = $_.BaseName + ".log" # 元の名前（拡張子なし）に ".log" を結合 Rename-Item -Path $_.FullName -NewName $newName }

Get-ChildItem -Path ".\*.txt": カレントディレクトリから拡張子が.txtのファイルを取得します。Get-ChildItemは-Pathでワイルドカードを使用できます。
|: パイプ演算子。Get-ChildItemの出力を次のコマンドレットに渡します。
ForEach-Object { ... }: パイプラインから渡されてきた各アイテムに対して、中括弧 {} 内のスクリプトブロックを実行します。
$_: ForEach-Objectのスクリプトブロック内で、現在処理中のアイテムを表す自動変数です。これはSystem.IO.FileInfoオブジェクト（ファイルの場合）またはSystem.IO.DirectoryInfoオブジェクト（フォルダの場合）です。
$_.BaseName: アイテムの名前から拡張子を除いた部分を取得します。
$_.FullName: アイテムの完全パスを取得します。Rename-Item -Pathには完全パスを指定するのが安全です。
$newName = $_.BaseName + ".log": 新しい名前を生成し、$newName変数に格納します。
Rename-Item -Path $_.FullName -NewName $newName: 現在のアイテム（完全パスで指定）の名前を$newNameに変更します。

この操作を行う前に、必ず-WhatIfを付けてテストしましょう。

powershell Get-ChildItem -Path ".\*.txt" | ForEach-Object { $newName = $_.BaseName + ".log" Rename-Item -Path $_.FullName -NewName $newName -WhatIf # WhatIfを追加 }

例5：ファイル名に接頭辞を追加する

カレントディレクトリにある全てのファイル名に「backup_」という接頭辞を追加したいとします。

powershell Get-ChildItem -Path ".\" -File | ForEach-Object { # -File パラメーターでファイルのみを取得 $newName = "backup_" + $_.Name # 元の名前全体に "backup_" を結合 Rename-Item -Path $_.FullName -NewName $newName -WhatIf }

Get-ChildItem -Path ".\" -File: カレントディレクトリからファイルのみを取得します（フォルダは除外）。-Fileは便利なスイッチパラメーターです。-Directoryを使えばフォルダのみを取得できます。
$_.Name: アイテムのファイル名全体（拡張子を含む）を取得します。

例6：ファイル名に連番を付ける

カレントディレクトリにある全ての.jpgファイルに「Image_001.jpg」、「Image_002.jpg」のように連番を付けたいとします。

“`powershell
$i = 1 # カウンター変数
Get-ChildItem -Path “.*.jpg” | ForEach-Object {
# Format-String を使って連番をゼロパディング
$newName = “Image_” + “{0:D3}” -f $i + $.Extension # 例: Image_001.jpg
Rename-Item -Path $.FullName -NewName $newName -WhatIf

$i++ # カウンターをインクリメント

}
“`

$i = 1: 連番の初期値を設定します。
"{0:D3}" -f $i: これは書式設定演算子-fを使った文字列の書式設定です。{0}は最初の引数（$i）、:D3は整数を3桁のゼロパディングで表示することを意味します。
$_.Extension: アイテムの拡張子（例: .jpg）を取得します。
$i++: 処理が終わるごとにカウンターを1増やします。

ForEach-Objectを使わない方法（NewNameにスクリプトブロックを渡す）

Rename-Itemの-NewNameパラメーターは、パイプラインからの入力がある場合に限り、文字列だけでなくスクリプトブロック{}を受け取ることができます。このスクリプトブロック内で$_を使用すると、パイプラインから渡された現在のアイテムにアクセスできます。これは、ForEach-Objectを使わずに同じような処理をより簡潔に書ける場合があることを意味します。

注意点: -NewNameにスクリプトブロックを渡す方法は、Get-ChildItemなどのコマンドレットからパイプラインでアイテムを渡した場合にのみ機能します。単一の-Path指定ではスクリプトブロックは機能しません。また、この方法では-WhatIfや-Confirmがアイテムごとに個別に動作するのではなく、Rename-Itemコマンドレット全体に対して一度だけ適用される場合があります。安全のため、やはりForEach-Objectと組み合わせて各Rename-Item呼び出しに-WhatIfを付ける方が確実です。

しかし、挙動を知っておくことは重要です。上記の例4（拡張子変更）をこの方法で書いてみます。

powershell Get-ChildItem -Path ".\*.txt" | Rename-Item -NewName { $_.BaseName + ".log" } -WhatIf

これは非常に簡潔です。パイプラインから渡された各.txtファイルオブジェクトに対して、Rename-Itemは-NewNameのスクリプトブロックを実行し、その結果の文字列を新しい名前として使用します。

この方法の利点はコードの簡潔さですが、連番を付けるような場合はカウンター変数の管理が必要になるため、ForEach-Objectの方が適しています。複雑なロジックで新しい名前を生成する場合は、ForEach-Object内にスクリプトブロックを書く方が柔軟性が高いでしょう。

高度な名前変更テクニック

Rename-ItemとPowerShellの文字列操作機能、正規表現などを組み合わせることで、非常に複雑な名前変更の要求にも対応できます。新しい名前を生成するスクリプトブロック内で、PowerShellのあらゆる機能を利用できるのが強みです。

文字列操作メソッドの使用

$_.Nameや$_.BaseNameは文字列なので、PowerShellの文字列操作メソッド（.Replace(), .Substring(), .Insert(), .PadLeft(), .Trim()など）を自由に使えます。

例7：ファイル名の一部を置き換える

ファイル名に含まれる「_v1」を「_final」に置き換えたいとします。

powershell Get-ChildItem -Path ".\*_v1.*" -File | ForEach-Object { # 元の名前の一部を置き換え $newName = $_.Name.Replace("_v1", "_final") Rename-Item -Path $_.FullName -NewName $newName -WhatIf }

$_.Name.Replace("_v1", "_final"): 現在のファイル名の中の文字列「_v1」を「_final」に置き換えた新しい文字列を生成します。

例8：ファイル名の最初の数文字を削除する

ファイル名の最初の5文字（例えば日付コードなど）を削除したいとします。

powershell Get-ChildItem -Path ".\*" -File | Where-Object { $_.BaseName.Length -gt 5 } | ForEach-Object { # 最初の5文字を削除 $newName = $_.Name.Substring(5) # インデックス5から末尾までを取得 Rename-Item -Path $_.FullName -NewName $newName -WhatIf }

Where-Object { $_.BaseName.Length -gt 5 }: ファイル名（拡張子除く）の長さが5文字より大きいものだけを選びます。短いファイル名を誤って処理しないためのフィルターです。
$_.Name.Substring(5): ファイル名文字列のインデックス5（6番目の文字）から始まり、末尾までの部分文字列を取得します。

正規表現を使用した高度な置き換え

PowerShellの-replace演算子を使用すると、正規表現を使ってファイル名内のパターンを検索し、置き換えることができます。これは非常に強力です。

例9：ファイル名内の特定のパターンを正規表現で置き換える

例えば、「Report_YYYYMMDD_Code.txt」のようなファイル名から日付部分を削除したい場合。（正規表現: _\d{8} は _ に続く8桁の数字にマッチ）

powershell Get-ChildItem -Path ".\Report_*.txt" -File | ForEach-Object { # 正規表現で "_YYYYMMDD" パターンを検索し、削除（空文字列に置き換え） $newName = $_.Name -replace "_\d{8}", "" Rename-Item -Path $_.FullName -NewName $newName -WhatIf }

$_.Name -replace "_\d{8}", "": 現在のファイル名に対して正規表現検索/置換を行います。_\d{8}にマッチする部分を空文字列（""）に置き換えます。

正規表現のキャプチャグループを使うと、マッチしたパターンの一部を取り出して新しい名前に組み込むこともできます。

例10：ファイル名の日付形式を変更する

ファイル名が「data_20231026.csv」のような形式で、これを「2023-10-26_data.csv」のように変更したい場合。（正規表現: (\w+)_(\d{4})(\d{2})(\d{2}) は「単語文字+_YYYYMMDD」にマッチし、部分をキャプチャ）

powershell Get-ChildItem -Path ".\data_????????.csv" -File | ForEach-Object { # 正規表現とキャプチャグループを使って新しい名前を組み立て # $1: キャプチャグループ1 (例: data) # $2: キャプチャグループ2 (例: 2023) # $3: キャプチャグループ3 (例: 10) # $4: キャプチャグループ4 (例: 26) $newName = $_.Name -replace "(\w+)_(\d{4})(\d{2})(\d{2})(\.csv)", "`$2-`$3-`$4_`$1`$5" Rename-Item -Path $_.FullName -NewName $newName -WhatIf }

(\w+)_(\d{4})(\d{2})(\d{2})(\.csv): この正規表現は、
- (\w+): 1つ以上の単語文字（英数字、アンダースコア）。これをグループ1 ($1) としてキャプチャ。
- _: アンダースコア。
- (\d{4}): 4桁の数字。グループ2 ($2)。
- (\d{2}): 2桁の数字。グループ3 ($3)。
- (\d{2}): 2桁の数字。グループ4 ($4)。
- (\.csv): .csvという文字列。（.は正規表現で任意の1文字なので、\.とエスケープが必要）。グループ5 ($5)。
"`$2-`$3-`$4_`$1`$5": 置換後の文字列パターンです。バッククォート（ ）で囲むことで、$記号を文字通りにエスケープし、$1,$2などがキャプチャグループ参照として解釈されるようにします。（引用符“で囲むと$1`などが変数として解釈されてしまうため）。ここでは、「YYYY-MM-DD_単語文字.csv」という順序に並べ替えています。

正規表現は強力ですが、習得には時間がかかります。しかし、一度使いこなせるようになれば、複雑なパターンに基づいた名前変更タスクを簡単に自動化できます。

フォルダ名の変更

上記で紹介したテクニックは、ファイルだけでなくフォルダにも適用できます。Get-ChildItem -Directoryを使ってフォルダのリストを取得し、ForEach-Objectまたは-NewNameスクリプトブロックで処理します。

例11：フォルダ名のスペースをアンダースコアに置き換える

カレントディレクトリにある全てのフォルダ名に含まれるスペースをアンダースコアに置き換えたいとします。

powershell Get-ChildItem -Path ".\" -Directory | ForEach-Object { $newName = $_.Name.Replace(" ", "_") # スペースが含まれている場合のみリネーム実行 if ($newName -ne $_.Name) { Rename-Item -Path $_.FullName -NewName $newName -WhatIf } }

Get-ChildItem -Path ".\" -Directory: カレントディレクトリからフォルダのみを取得します。
$_.Name.Replace(" ", "_"): フォルダ名内のスペースをアンダースコアに置き換えます。
if ($newName -ne $_.Name): これは名前が実際に変更される場合にのみRename-Itemを実行するための簡単なチェックです。スペースが含まれていないフォルダをスキップします。

異なるプロバイダーでのRename-Item

PowerShellのコマンドレットは「プロバイダー」と連携して動作します。ファイルシステムプロバイダー（FileSystem）はファイルやフォルダを扱いますが、他にもレジストリプロバイダー（Registry）、変数プロバイダー（Variable）、エイリアスプロバイダー（Alias）、関数プロバイダー（Function）などがあります。Rename-Itemはこれらのプロバイダーでも使用できます。

例12：レジストリキーの名前を変更する

レジストリのパス HKCU:\Software\MyApplication_v1 を HKCU:\Software\MyApplication_v2 に名前変更したい場合。

“`powershell

レジストリプロバイダーはドライブ名として HKCU: や HKLM: を使用

Rename-Item -Path “HKCU:\Software\MyApplication_v1” -NewName “MyApplication_v2” -WhatIf
“`

ファイルシステムと同様に-Pathと-NewNameを使います。-Pathにはプロバイダーのドライブ名を含むパスを指定します。

例13：変数の名前を変更する

定義済みの変数$oldVariableの名前を$newVariableに変更したい場合。

“`powershell
$oldVariable = “これはテスト値です”
Rename-Item -Path Variable:\oldVariable -NewName newVariable -WhatIf

変数プロバイダーでは Variable:\ というパスを使用

“`

変数を参照する際は$記号を使いますが、変数プロバイダーのパスとして指定する際は$は付けません（アイテム名がoldVariableだからです）。

例14：エイリアスの名前を変更する

既存のエイリアスgci（Get-ChildItemのエイリアス）の名前をlistに変更したい場合。

“`powershell

エイリアスプロバイダーでは Alias:\ というパスを使用

Rename-Item -Path Alias:\gci -NewName list -WhatIf

エイリアス一覧を確認するには Get-ChildItem Alias:\ を使用

Get-ChildItem Alias:

“`

これらの例からわかるように、Rename-Itemコマンドレットの基本的な使い方はどのプロバイダーでも共通しています。-Pathで適切なプロバイダーパスを指定すれば、ファイルシステムと同じようにアイテムの名前を変更できます。

エラー処理

Rename-Itemコマンドレットは、操作が成功しなかった場合にエラーを発生させます。よくあるエラーシナリオと、それに対処する方法を見ていきましょう。

よくあるエラー

アイテムが見つからない: 指定した-Pathにアイテムが存在しない場合。
powershell Rename-Item -Path "non_existent_file.txt" -NewName "new_name.txt" # エラー: Cannot find path 'C:\path\to\non_existent_file.txt' because it does not exist.
これはパスが間違っているか、アイテムが既に削除された場合に起こります。Get-ChildItemなどで事前に存在確認をするのが有効です。
アクセスが拒否された: 名前を変更するアイテムに対して、現在のユーザーに適切な権限がない場合。
powershell Rename-Item -Path "C:\Program Files\some_file.dll" -NewName "other_name.dll" # エラー: Access to the path 'C:\Program Files\some_file.dll' is denied.
管理者権限が必要な場所や、ファイルが別のプロセスによってロックされている場合に発生します。PowerShellを管理者として実行するか、ロックしているプロセスを特定して終了させる必要があります。-Forceパラメーターは権限の問題を解決しません。
アイテムが既に存在する: -NewNameで指定した名前のアイテムが既に同じ場所に存在する場合。
powershell # file_a.txt と file_b.txt が存在する場合に以下を実行 Rename-Item -Path "file_a.txt" -NewName "file_b.txt" # エラー: An item with the name 'file_b.txt' already exists in this location.
デフォルトでは、既に存在する名前に変更しようとするとエラーになります。意図的に上書きしたい場合は、一度既存のアイテムを削除する必要があります（通常、名前変更で上書きはできません）。
パスが無効: -NewNameに含まれる文字がファイルシステムで許可されていない場合。
powershell Rename-Item -Path "valid.txt" -NewName "invalid*name.txt" # エラー: The given path's format is not supported.
新しい名前に\ / : * ? " < > | などを含めると発生します。

エラーアクションパラメーター (`-ErrorAction`)

全てのコマンドレットと同様に、Rename-Itemも-ErrorAction共通パラメーターをサポートしています。これにより、エラーが発生した場合のPowerShellの挙動を制御できます。

-ErrorAction Continue (デフォルト): エラーメッセージを表示し、スクリプトの実行を続けます。
-ErrorAction SilentlyContinue: エラーメッセージを表示せず、スクリプトの実行を続けます。
-ErrorAction Stop: エラーが発生した場合、エラーメッセージを表示し、スクリプトの実行を停止します。
-ErrorAction Inquire: エラーが発生した場合、ユーザーにどうするかを問い合わせるプロンプトを表示します（-Confirmと似ていますが、こちらはエラー時のみ）。

大量のファイル処理などで、一部のエラーは許容して処理を続行したいが、エラーメッセージは抑制したいという場合は-ErrorAction SilentlyContinueが便利です。

“`powershell

存在しないファイルを無視して処理を続行

Rename-Item -Path “non_existent.txt” -NewName “should_not_happen.txt” -ErrorAction SilentlyContinue

他の処理…

“`

`Try-Catch`ブロックを使用したより高度なエラー処理

より堅牢なスクリプトを作成するには、Try-Catchブロックを使用して特定のエラーを捕捉し、それに応じた処理を行うのが最善です。

“`powershell
Get-ChildItem -Path “.*.txt” -ErrorAction SilentlyContinue | ForEach-Object {
$oldPath = $.FullName
$newName = $.BaseName + “.log”
$newPath = Join-Path -Path $_.DirectoryName -ChildPath $newName

try {
    Rename-Item -Path $oldPath -NewName $newName -ErrorAction Stop -PassThru # エラー発生時はここで停止させる
    Write-Host "Successfully renamed '$oldPath' to '$newPath'" -ForegroundColor Green
}
catch [System.IO.FileNotFoundException] {
    Write-Warning "File not found: '$oldPath'. Skipping."
}
catch [System.UnauthorizedAccessException] {
    Write-Warning "Permission denied for '$oldPath'. Skipping."
}
catch [System.IO.IOException] {
    # ファイルが使用中など、IO関連の他のエラー
    Write-Warning "IO Error renaming '$oldPath': $($_.Exception.Message). Skipping."
}
catch {
    # その他の未知のエラー
    Write-Warning "An unexpected error occurred while renaming '$oldPath': $($_.Exception.Message). Skipping."
}

}
“`

この例では、ForEach-Objectループ内で個々のRename-Item呼び出しをTry-Catchで囲んでいます。
* Rename-Item自体には-ErrorAction Stopを指定し、エラーが発生したらすぐにCatchブロックに処理を移すようにしています。
* Catchブロックでは、特定のエラータイプ（[System.IO.FileNotFoundException]、[System.UnauthorizedAccessException]、[System.IO.IOException]など）を指定して、それぞれに対応したエラーメッセージを表示したり、ログに記録したり、別の処理を行ったりできます。
* 最後の無指定のcatchブロックは、予期しないその他のエラーを捕捉します。
* $_.Exception.Messageで、発生したエラーの詳細メッセージを取得できます。

このアプローチは、大量のアイテムを処理する際に、特定のエラーが発生してもスクリプト全体が停止するのを防ぎつつ、問題が発生したアイテムを特定してログに残すなど、より洗練されたエラーハンドリングを可能にします。

実践的なリネーム例

これまでに学んだことを応用して、いくつかの実践的なリネームシナリオを解決するスクリプトを見てみましょう。

例15：撮影日をファイル名に追加する (写真ファイル向け)

デジカメで撮影した写真ファイル（.jpg）に、Exif情報から取得した撮影日を「YYYYMMDD_」の形式でファイル名の先頭に追加したいとします。これには、Exif情報を読み取るための追加の手順が必要になることがあります。ここでは、.NETフレームワークのクラスを利用する方法の概念を示しますが、より簡単に扱える外部モジュール（例: ReadMetaData）も存在します。

.NETのSystem.Drawing.Imaging.PropertyItemを使う方法は少し複雑なので、ここではファイル自体の更新日時を使うシンプルな例を示します。実際の撮影日情報（Exif）を使うには、もう少し高度なスクリプトか専用ツールが必要です。

例15a：ファイルの更新日時をファイル名に追加

ファイルの最終更新日時を「YYYYMMDD_」の形式でファイル名に含めます。

“`powershell
Get-ChildItem -Path “.*.jpg” -File | ForEach-Object {
$item = $_ # 現在のアイテムオブジェクト
$lastWriteTime = $item.LastWriteTime # 最終更新日時を取得

# 日時を "YYYYMMDD" 形式の文字列にフォーマット
$datePrefix = $lastWriteTime.ToString("yyyyMMdd") + "_"

$newName = $datePrefix + $item.Name
Rename-Item -Path $item.FullName -NewName $newName -WhatIf

}
“`

$item.LastWriteTime: アイテムの最終更新日時（DateTimeオブジェクト）を取得します。
$lastWriteTime.ToString("yyyyMMdd"): DateTimeオブジェクトの.ToString()メソッドを使って、指定した形式（yyyy=年4桁, MM=月2桁, dd=日2桁）で文字列に変換します。

例16：特定の文字列パターンを含むファイルを別のフォルダに移動しながら名前変更

「report_」で始まるファイルを別のフォルダ「.\ArchivedReports」に移動し、名前に現在の年月「_YYYYMM」を追加したいとします。

“`powershell

アーカイブフォルダが存在しない場合は作成

$archiveFolder = “.\ArchivedReports”
if (-not (Test-Path $archiveFolder -PathType Container)) {
New-Item -Path $archiveFolder -ItemType Directory | Out-Null
}

$currentYearMonth = Get-Date -Format “yyyyMM” # 現在の年月を取得

Get-ChildItem -Path “.\report_*.txt” -File | ForEach-Object {
$item = $_
$oldPath = $item.FullName

# 新しいファイル名を生成 (元の名前 + "_YYYYMM" + 拡張子)
$newName = $item.BaseName + "_" + $currentYearMonth + $item.Extension

# 新しい保存先パスを生成 (アーカイブフォルダ + 新しいファイル名)
$newPath = Join-Path -Path $archiveFolder -ChildPath $newName

# 名前を変更しながら移動
# Move-Item コマンドレットを使用します
# Rename-Item は移動機能を持たないので、この場合は Move-Item が適切
# Move-Item の -Destination パラメーターは、新しいパスを指定できます
# 新しいパスには、新しいフォルダと新しい名前を含める必要があります
try {
     Move-Item -Path $oldPath -Destination $newPath -WhatIf -ErrorAction Stop
     Write-Host "Archived and renamed '$($item.Name)' to '$newName' in '$archiveFolder'" -ForegroundColor Green
}
catch {
    Write-Warning "Failed to archive and rename '$($item.Name)': $($_.Exception.Message)"
}

}
“`

この例では、厳密にはRename-ItemだけでなくMove-Itemを使用しています。これは、名前変更と同時に別の場所に移動させる場合はMove-Item -Destination <新しいパスと新しいファイル名>を使うのが一般的だからです。Rename-Itemは名前の変更のみを行い、移動はできません。
Join-Path: フォルダパスとファイル名を結合して正しいパス文字列を作成するのに便利なコマンドレットです。
Get-Date -Format "yyyyMM": 現在の日時を取得し、指定した形式で文字列に変換します。

もし、同じフォルダ内で名前だけ変更したい場合は、Rename-Itemを使い続けます。

“`powershell

同じフォルダ内で、ファイル名に “_YYYYMM” を追加

$currentYearMonth = Get-Date -Format “yyyyMM”

Get-ChildItem -Path “.\report_*.txt” -File | ForEach-Object {
$item = $_
$oldPath = $item.FullName

# 新しいファイル名を生成 (元の名前 + "_YYYYMM" + 拡張子)
$newName = $item.BaseName + "_" + $currentYearMonth + $item.Extension

Rename-Item -Path $oldPath -NewName $newName -WhatIf

}
“`

例17：ファイル名の全角スペースを半角スペースに、半角スペースをアンダースコアに変換

ファイル名に含まれる全角スペースを半角スペースに、その後、存在する全ての半角スペースをアンダースコアに置換したいとします。

“`powershell
Get-ChildItem -Path “.\” -File | ForEach-Object {
$item = $_
$oldName = $item.Name

# 全角スペースを半角スペースに置換
$tempName = $oldName.Replace("　", " ")

# 半角スペースをアンダースコアに置換
$newName = $tempName.Replace(" ", "_")

# 名前が変更される場合のみ実行
if ($newName -ne $oldName) {
    Rename-Item -Path $item.FullName -NewName $newName -WhatIf
}

}
“`

.Replace("　", " "): 全角スペースを半角スペースに置換します。
.Replace(" ", "_"): 半角スペースをアンダースコアに置換します。置換は左から右に順に行われるため、全角スペースは最初に半角スペースになり、その半角スペースが次にアンダースコアに変わります。

例18：フォルダ内の全てのファイルとサブフォルダの名前を小文字に変換（再帰処理）

指定したフォルダ以下の全てのファイルとサブフォルダの名前を小文字に変換したい場合。Get-ChildItem -Recurseを使用します。

“`powershell

対象フォルダ

$targetFolder = “.\MyDataFolder”

対象フォルダ以下の全てのアイテム（ファイルとフォルダ両方）を再帰的に取得

Get-ChildItem -Path $targetFolder -Recurse | ForEach-Object {
$item = $_
$oldName = $item.Name
$newName = $oldName.ToLower() # 名前を小文字に変換

# 名前が変更される場合のみ実行
if ($newName -ne $oldName) {
    # 元のパスは Get-ChildItem の出力から取得 ($_ .FullName)
    # 新しい名前は ToLower() で生成
    Rename-Item -Path $item.FullName -NewName $newName -WhatIf
}

}
“`

Get-ChildItem -Recurse: 指定したパス以下のサブフォルダも含む全てのアイテムを取得します。
$item.Name.ToLower(): アイテム名（ファイル名またはフォルダ名）全体を小文字に変換します。
Rename-Itemは、Get-ChildItem -Recurseが生成するオブジェクトに対して順に実行されるため、サブフォルダの中のアイテムも正しく処理されます。ただし、再帰的な処理では、親フォルダの名前変更が子アイテムのパスに影響を与える可能性があるため、注意が必要です。このスクリプトでは、$_.FullNameを使用しているため、Rename-Itemが呼ばれる時点でのアイテムの完全な現在のパスに基づいて操作が行われます。PowerShellは通常この種の依存関係を適切に扱いますが、非常に複雑な再帰的リネームではテストが不可欠です。

その他の考慮事項とベストプラクティス

-WhatIfを常に使用する: 大量のファイルや重要なファイルを扱う前に、-WhatIfを使ってコマンドの効果をシミュレーションすることは、最も重要なベストプラクティスです。これにより、意図しない名前変更を防ぐことができます。
-Confirmを試す: 数が少ない場合や、非常に重要なファイルを扱う場合は、-Confirmを使って個別の確認を行うのも良い方法です。
バックアップを取る: 重要なファイルやフォルダに対して複雑なリネームを行う前には、必ずバックアップを取るか、テスト用のコピーで試してください。
小さなバッチでテストする: 大量のファイルを一度に処理する前に、まずは一部のファイルに対してスクリプトを実行してテストすることをおすすめします。
名前の競合: Rename-Itemはデフォルトで名前の競合（既に同じ名前のアイテムが存在する場合）を許可しません。上書きしたい場合は、事前に古いアイテムを削除するロジックを組み込む必要があります（ただし、通常のリネームで上書きは推奨されませんし、意図しないデータ消失につながる可能性があります）。
パフォーマンス: Get-ChildItemで大量のファイルやフォルダを取得すると、時間がかかる場合があります。必要に応じて-Depthパラメーターで取得する階層を制限したり、-Filterや-Include/-Excludeパラメーターを効果的に使って取得対象を絞り込むことで、パフォーマンスを改善できます。Rename-Item自体は比較的軽量な操作です。
トランザクション: PowerShellのファイルシステム操作はデフォルトではトランザクションをサポートしていません。つまり、複数のアイテムを処理中にエラーが発生しても、それまでに行われた名前変更は元に戻りません。もしアトミックな操作（全て成功するか全て失敗するか）が必要な場合は、PowerShellのトランザクション機能（Start-Transactionなど）を検討する必要がありますが、ファイルシステム操作でのトランザクションは制限があるため、一般的には手動での復旧手順を考慮するか、より高度なファイル管理システムを使用します。
他のツールとの比較: Rename-ItemはPowerShellの統一されたオブジェクト指向のパイプラインと連携するため、柔軟性が高く、他のコマンドレット（Where-Object、Select-Object、Get-ItemPropertyなど）と組み合わせて複雑な条件に基づいた名前変更が可能です。Unix/Linux系のmvコマンドも名前変更に使われますが、PowerShellのRename-ItemはPowerShellのプロバイダーモデルに対応している点が大きな違いです。

まとめ

Rename-Itemコマンドレットは、PowerShellでアイテムの名前を変更するための標準的かつ非常に強力なツールです。単一のアイテムの簡単な名前変更から始め、-Path、-NewNameといった基本パラメーターの使い方を学びました。

次に、Get-ChildItemとForEach-Object、あるいは-NewNameへのスクリプトブロックのパイプラインを組み合わせることで、複数のファイルやフォルダの名前を一括で変更する方法を習得しました。

さらに、文字列操作メソッドや正規表現-replace演算子を活用して、ファイル名の一部を置き換えたり、パターンに基づいて名前を生成したりといった高度なテクニックを探求しました。

ファイルシステムだけでなく、レジストリ、変数、エイリアスなどの異なるPowerShellプロバイダー上でもRename-Itemが同様に機能することを確認し、その汎用性を理解しました。

最後に、エラー処理の重要性、-ErrorActionパラメーターやTry-Catchブロックを使った堅牢なスクリプトの書き方、そして実際のシナリオに基づいた実践的なリネーム例を通じて、Rename-Itemを効果的に活用するためのベストプラクティスを学びました。

Rename-Itemは、PowerShellを使った自動化において非常に頻繁に利用されるコマンドレットです。このガイドで得た知識を活用し、ぜひ様々な名前変更タスクを自動化してみてください。-WhatIfを使った慎重なテストを忘れずに、PowerShellによる効率的な作業環境を構築していきましょう。

PowerShell Rename-Itemコマンドの使い方完全ガイド

はじめに：なぜRename-Itemを学ぶのか？

Rename-Itemの基本構文

例1：単一のファイルの名前を変更する

例2：単一のフォルダの名前を変更する

例3：相対パスを使用する

現在の場所が report.docx があるフォルダの場合

Rename-Itemの主要パラメーターの詳細

-Path および -LiteralPath

-NewName

-ItemType

-Force

-WhatIf

-Confirm

-PassThru

複数のアイテムの名前を変更する

例4：特定の拡張子を持つファイルの名前を一括変更する

例5：ファイル名に接頭辞を追加する

例6：ファイル名に連番を付ける

ForEach-Objectを使わない方法（NewNameにスクリプトブロックを渡す）

高度な名前変更テクニック

文字列操作メソッドの使用

正規表現を使用した高度な置き換え

フォルダ名の変更

異なるプロバイダーでのRename-Item

レジストリプロバイダーはドライブ名として HKCU: や HKLM: を使用

変数プロバイダーでは Variable:\ というパスを使用

エイリアスプロバイダーでは Alias:\ というパスを使用

エイリアス一覧を確認するには Get-ChildItem Alias:\ を使用

Get-ChildItem Alias:

エラー処理

よくあるエラー

エラーアクションパラメーター (-ErrorAction)

存在しないファイルを無視して処理を続行

他の処理…

Try-Catchブロックを使用したより高度なエラー処理

実践的なリネーム例

例15：撮影日をファイル名に追加する (写真ファイル向け)

例16：特定の文字列パターンを含むファイルを別のフォルダに移動しながら名前変更

アーカイブフォルダが存在しない場合は作成

同じフォルダ内で、ファイル名に “_YYYYMM” を追加

例17：ファイル名の全角スペースを半角スペースに、半角スペースをアンダースコアに変換

例18：フォルダ内の全てのファイルとサブフォルダの名前を小文字に変換（再帰処理）

対象フォルダ

対象フォルダ以下の全てのアイテム（ファイルとフォルダ両方）を再帰的に取得

その他の考慮事項とベストプラクティス

まとめ

コメントする 返信をキャンセル

`-Path` および `-LiteralPath`

`-NewName`

`-ItemType`

`-Force`

`-WhatIf`

`-Confirm`

`-PassThru`

エラーアクションパラメーター (`-ErrorAction`)

`Try-Catch`ブロックを使用したより高度なエラー処理

コメントする返信をキャンセル