Move-Item

構文

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Move-Item
    -LiteralPath <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Move-Item コマンドレットは、プロパティ、コンテンツ、子項目などの項目を 1 つの場所から別の場所に移動します。 移動元と移動先は、どちらも同じプロバイダーでサポートされている必要があります。

たとえば、ファイルやサブディレクトリを別のディレクトリに移動したり、レジストリのサブキーを別のキーに移動したりできます。 移動した項目は新しい場所に追加され、元の場所から削除されます。

例

例 1: ファイルを別のディレクトリに移動して名前を変更する

このコマンドは、 Test.txt ファイルを C: ドライブから E:\Temp ディレクトリに移動し、 test.txt から tst.txt に名前を変更します。

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

例 2: ディレクトリとその内容を別のディレクトリに移動する

このコマンドは、 C:\Temp ディレクトリとその内容を C:\Logs ディレクトリに移動します。 Temp ディレクトリとそのすべてのサブディレクトリとファイルが、Logs ディレクトリに表示されます。

Move-Item -Path C:\Temp -Destination C:\Logs

例 3: 指定した拡張子のすべてのファイルを現在のディレクトリから別のディレクトリに移動する

このコマンドは、現在のディレクトリ (ドット (.) で表される) 内のすべてのテキスト ファイル (*.txt) をC:\Logs ディレクトリに移動します。

Move-Item -Path .\*.txt -Destination C:\Logs

例 4: 指定した拡張子のすべてのファイルを現在のディレクトリから別のディレクトリに再帰的に移動する

このコマンドは、すべてのテキスト ファイルを現在のディレクトリとすべてのサブディレクトリから C:\TextFiles ディレクトリに再帰的に移動します。

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

このコマンドでは、 Get-ChildItem コマンドレットを使用して、現在のディレクトリ (ドット (.) で表される) 内のすべての子項目と、 *.txt ファイル名拡張子を持つサブディレクトリを取得します。 Recurse パラメーターを使用して取得を再帰的にし、Include パラメーターを使用して、*.txt ファイルへの取得を制限します。

パイプライン演算子 (|) は、このコマンドの結果を Move-Item に送信し、テキスト ファイルを TextFiles ディレクトリに移動します。

C:\Textfilesに移動するファイルの名前が同じである場合、Move-Itemはエラーを表示して続行しますが、各名前のファイルは 1 つだけC:\Textfilesに移動します。 その他のファイルは元のディレクトリに残ります。

Textfiles ディレクトリ (または宛先パスの他の要素) が存在しない場合、コマンドは失敗します。 Force パラメーターを使用した場合でも、不足しているディレクトリは自動的に作成されません。 Move-Item は、最初の項目を Textfiles という名前のファイルに移動し、ファイルが既に存在することを説明するエラーを表示します。

また、既定では、 Get-ChildItem は非表示のファイルを移動しません。 非表示のファイルを移動するには、Get-ChildItemで Force パラメーターを使用します。

例 5: レジストリ キーと値を別のキーに移動する

このコマンドは、HKLM\SoftwareのMyCompany レジストリ キー内のレジストリ キーと値をMyNewCompany キーに移動します。 ワイルドカード文字 (*) は、キー自体ではなく、 MyCompany キーの内容を移動する必要があることを示します。 このコマンドでは、省略可能な Path および Destination パラメーター名は省略されます。

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

例 6: 指定したディレクトリのサブディレクトリにディレクトリとその内容を移動する

このコマンドは、 Logs[Sept`06] ディレクトリ (およびその内容) を Logs[2006] ディレクトリに移動します。

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

元のディレクトリ名には左角かっこと右角かっこ ([と]) が含まれているため、Path の代わりに LiteralPath パラメーターが使用されます。 パスも単一引用符 (') で囲まれているため、バッククォート記号 (`) が誤って解釈されません。

Destinationパラメーターには、誤って解釈できる角かっこが含まれているため、単一引用符で囲む必要もあります。

パラメーター

-Confirm

-Credential

-Destination

-Exclude

-Filter

-Force

-Include

-LiteralPath

-PassThru

-Path

-WhatIf

入力

String

このコマンドレットへのパスを含む文字列をパイプ処理できます。

出力

None

既定では、このコマンドレットは出力を返しません。

PSObject

PassThru パラメーターを使用すると、このコマンドレットは移動された項目を表すオブジェクトを返します。

メモ

PowerShell には、 Move-Itemの次のエイリアスが含まれています。

• すべてのプラットフォーム:

  • mi
  • move

• Windows:

  • mv

• このコマンドレットは、同じプロバイダーでサポートされているドライブ間でファイルを移動しますが、同じドライブ内でのみディレクトリを移動します。

• Move-Item コマンドは項目のプロパティ、内容、および子項目を移動するため、すべての移動は既定で再帰的です。

• このコマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「 Get-PSProvider」と入力します。 詳細については、「 about_Providers」を参照してください。

関連リンク

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers