Move-Item

Move-Item [-LiteralPath] <string[]> [[-Destination] <string>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Move-Item [-Path] <string[]> [[-Destination] <string>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>move-item -path C:\test.txt -destination E:\Temp\tst.txt

説明
-----------
このコマンドを実行すると、test.txt ファイルが C: ドライブから E:\Temp ディレクトリに移動され、名前が test.txt から tst.txt に変更されます。

C:\PS>move-item -path C:\Temp -destination C:\Logs

説明
-----------
このコマンドを実行すると、C:\Temp ディレクトリとその内容が C:\Logs ディレクトリに移動されます。Temp ディレクトリと、そのすべてのサブディレクトリおよびファイルが、Logs ディレクトリに格納されます。

C:\PS>move-item -path .\*.txt -destination C:\Logs

説明
-----------
このコマンドを実行すると、現在のディレクトリ (ドット (.) で指定) にあるすべてのテキスト ファイル (*.txt) が C:\Logs ディレクトリに移動されます。

C:\PS>get-childitem -path . -recurse -include *.txt | move-item -destination C:\TextFiles

説明
-----------
このコマンドを実行すると、現在のディレクトリとそのすべてのサブディレクトリにあるテキスト ファイルが、すべて再帰的に 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 パラメーターを使用します。

C:\PS>move-item hklm:\software\mycompany\* hklm:\software\mynewcompany

説明
-----------
このコマンドを実行すると、HKLM\Softwar 内の MyCompany レジストリ キー内のレジストリ キーと値が MyNewCompany キーに移動されます。ワイルドカード文字 (*) は、MyCompany キー自体ではなく、その内容を移動することを示します。このコマンドでは、省略可能なパラメーター名 Path と Destination が省略されています。

C:\PS>move-item -literalpath 'Logs[Sept`06]' -destination 'Logs[2006]'

説明
-----------
このコマンドを実行すると、Logs[Sept`06] ディレクトリとその内容が Logs[2006] ディレクトリに移動されます。

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

Destination パラメーターではリテラル パスは必要ありません。これは、Destination に誤って解釈される可能性がある角かっこが含まれているため、Destination 変数も単一引用符で囲む必要があるためです。