PowerShellのファイル操作:コピー・移動・削除を練習用フォルダーで確認

受け取りの元ファイルを残してコピーし、コピーを移動してから削除予告を確認する3段階の独自図解

コピーは元ファイルを残し、移動は移動前の場所から対象をなくします。PowerShellではCopy-ItemとMove-Itemがそれぞれの命令です。専用の練習フォルダーで操作し、前後の存在・名前・内容を比べると、その違いを確かめられます。

必要なのはWindows PowerShell 5.1を開けるWindows環境です。通常権限で作成・読取り・追記・コピー・移動・改名・検索を順に進めます。削除するのは練習で作るコピー1件だけです。元ファイルを残し、削除予告と実際の削除を分けて確認します。

先に結論

  • コピーは元を残し、移動は移動前の場所から対象をなくします。操作後は元と先の両方を確認します。
  • 同じPowerShell画面で掲載順に進めます。途中の移動や削除をやり直すときは、新しい練習フォルダーを作ります。
  • 角括弧を含む名前はLiteralPathで文字どおり指定し、コピーや移動の前には保存先がフォルダーか確認します。
  • WhatIfは削除の予告です。対象を確認してからコピー1件だけを削除し、コピーがなくなったことと元が残ることを確かめます。

1.Windows PowerShellを通常権限で開き、版を確認する

掲載例の対象はWindows PowerShell 5.1です。管理者権限は不要です。

最初に、起動したPowerShellの版と系統を調べます。コマンドは操作の命令、パラメーターはハイフンで始まる指定です。後の節でも、この2つを組み合わせてファイルを操作します。

$で始まる名前は、値を覚えておく変数です。$PSVersionTableには動作中のPowerShellの情報が入り、PSVersionは版、PSEditionは系統を示します。

  1. Windowsのスタートメニューで「Windows PowerShell」を検索し、通常の権限で開きます。
  2. PSで始まる入力行へ、次のコード欄の2行を貼り付けてEnterを押します。出力欄の文字は貼り付けません。

PowerShellの版を確認する

$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition

実行結果

5.1.26100.9818
Desktop

掲載結果の5.1.26100.9818はWindows PowerShell 5.1系です。Desktopはその系統の表示です。細かな版番号は環境で変わりますが、5.1系・Desktop以外なら、ここで起動したアプリを確認してください。

掲載結果はWindows PowerShell 5.1でのものです。PowerShell 7、macOS、ネットワーク共有では実行していません。以降も同じ画面で進め、各コード欄の最後の行までを実行対象にします。

2.実務のファイルと分けて、専用の練習場所を作る

Windowsの一時領域に、毎回新しい練習フォルダーを作ります。

ディレクトリはフォルダー、パスはファイルやフォルダーの場所を表す文字列です。次のコードはTEMPという一時領域の下に、PSFilePracticeで始まる専用フォルダーを作ります。

=は右の値を左の変数へ保存する記号です。Join-Pathは場所と名前をつなぎ、GUIDは重複しにくい識別子を作るために使います。保存先を実務フォルダーやDocumentsへ変更する必要はありません。

New-ItemのItemType Directoryはフォルダー作成の指定です。縦棒のパイプは左の結果を右へ渡し、Out-Nullは結果の画面表示だけを省きます。ErrorAction Stopはエラー時に処理を停止させる指定です。

準備のSet-Contentは、練習用の2ファイルへ初期内容を書き込みます。同名ファイルがあれば内容を置き換える命令なので、保存先の変数を実務のファイルへ変更しないでください。

  1. 節1と同じ画面で、次のコード欄を先頭から最後の一覧表示まで実行します。
  2. 控え・受け取り・保留が表示されたことを確認します。エラーが出た場合は次の節へ進まず、表示された対象と練習場所を確認します。

専用の練習フォルダーと入力を作る

$start = (Get-Location).Path
$lab = Join-Path $env:TEMP ('PSFilePractice-' + [guid]::NewGuid().ToString('N'))
New-Item -Path $lab -ItemType Directory -ErrorAction Stop | Out-Null
$source = Join-Path $lab '受け取り'
$copyDir = Join-Path $lab '控え'
$moveDir = Join-Path $lab '保留'
New-Item -Path $source, $copyDir, $moveDir -ItemType Directory -ErrorAction Stop | Out-Null
$file = Join-Path $source 'メモ[3].txt'
$similar = Join-Path $source 'メモ3.txt'
Set-Content -LiteralPath $file -Value 'first' -Encoding UTF8
Set-Content -LiteralPath $similar -Value '別のファイル' -Encoding UTF8
Set-Location -LiteralPath $lab
(Get-ChildItem -LiteralPath $lab -Directory | Sort-Object Name).Name

実行結果

控え
受け取り
保留

控え・受け取り・保留の3つの名前が出れば、準備できています。最後のGet-ChildItemがフォルダー一覧を読み、Directoryでフォルダーに限定し、Sort-Object Nameで名前順に並べています。

$startは最初の作業場所、$labは今回の練習場所を記憶します。Get-Locationは現在の場所を読み、Set-Locationは現在の場所を変えます。この操作でファイル自体が移動するわけではありません。

受け取りには、操作用のメモ[3].txtと、比較用のメモ3.txtができます。以降、$fileは角括弧を含むメモ[3].txtを指します。2つの名前が似ていても、別のファイルです。

3.角括弧を含む名前はLiteralPathで指定する

引用符で囲むことと、名前を文字どおり指定することは役割が異なります。

ワイルドカードは、名前を探す条件に使う記号です。Pathでは角括弧も条件として解釈されます。メモ[3].txtの[3]は3という1文字に合うため、比較用のメモ3.txtが選ばれます。

引用符は空白を含む文字列などをひとまとまりにしますが、Pathへ渡した後のパターン解釈までは止めません。LiteralPathは、その解釈をせず、指定した名前を文字どおり扱います。

次の2行は情報を読むだけで、ファイルを変更しません。Get-Itemは指定した対象の情報を取得し、Nameでその名前を表示します。2行とも実行して、選ばれた名前を比べます。

角括弧を含む名前を指定する

(Get-Item -Path $file).Name
(Get-Item -LiteralPath $file).Name

実行結果

メモ3.txt
メモ[3].txt

1行目は比較用のメモ3.txt、2行目は操作したいメモ[3].txtです。以降はLiteralPathで、角括弧を含むほうを選びます。

LiteralPathは名前の指定方法です。権限や内容の安全性を確認する機能ではありません。また、新しい場所を作るNew-ItemではPath、コピー先ではDestinationという指定を使います。

4.追記と置換で、残る内容を比べる

Add-Contentは末尾へ追記し、Set-Contentはそれまでの内容を置き換えます。

次のコードで書き換えるのは、受け取りのメモ[3].txtだけです。最初にAdd-Contentでsecondを追記し、Get-Contentで読みます。その後、Set-Contentでreplacementへ置き換え、もう一度読みます。

Valueは書き込む文字、Encoding UTF8は文字コードの指定です。文字コードは、文字をバイト列で保存するための約束です。この例では書込みと読取りをUTF8にそろえ、既定値に依存しないようにしています。

追記と置換の違いを確かめる

Add-Content -LiteralPath $file -Value 'second' -Encoding UTF8
Get-Content -LiteralPath $file -Encoding UTF8
Set-Content -LiteralPath $file -Value 'replacement' -Encoding UTF8
Get-Content -LiteralPath $file -Encoding UTF8

実行結果

first
second
replacement

最初のGet-Contentがfirstとsecondの2行を出し、最後のGet-Contentがreplacementの1行を出します。出力欄の3行すべてが、最後のファイル内容という意味ではありません。

この節の後、元ファイルの内容はreplacementです。置換前の2行は残りません。操作をやり直す場合は、節2で新しい練習フォルダーを作ります。既存データへ対象を変更して試さないでください。

5.コピー先を確認してから、元を残してコピーする

先頭行だけでコピー先を確認し、Trueだった場合に残りを実行します。

Copy-Itemは元ファイルを残してコピーします。Destinationは既存フォルダーにも新しいファイル名にもなり得る指定です。今回は準備済みの控えフォルダーを確認し、その中の控え[3].txtまで保存先を指定します。

Test-Pathは存在を調べる命令です。PathTypeのContainerはフォルダー、Leafはファイルに対象を限定します。Trueは指定した条件に合う対象があるという表示です。Falseなら先へ進まず、準備を見直します。

同名ファイルへのコピーは上書きされる場合があります。この練習では新しいフォルダーで一度ずつ進めます。強制指定のForceを追加して、途中の状態を無理に変更しないでください。

  1. 次のコード欄の1行目、Test-Pathだけを実行します。
  2. Falseが出た場合やエラーが出た場合は、2行目以降を実行せず、練習場所の準備を確認します。
  3. Trueを確認できた場合だけ、2行目から最後のハッシュ比較までを実行します。コード欄全体を最初から一括で貼り付けないでください。

フォルダーを確認してファイルをコピーする

Test-Path -LiteralPath $copyDir -PathType Container
$copied = Join-Path $copyDir '控え[3].txt'
Copy-Item -LiteralPath $file -Destination $copied -ErrorAction Stop
Test-Path -LiteralPath $file -PathType Leaf
Test-Path -LiteralPath $copied -PathType Leaf
(Get-FileHash -LiteralPath $file).Hash -eq (Get-FileHash -LiteralPath $copied).Hash

実行結果

True
True
True
True

出力の4つのTrueは、順にコピー先フォルダーの存在、元ファイルの存在、コピーの存在、両者のハッシュ一致を示します。先頭行の結果と、その後の3つの結果を分けて読みます。

ハッシュは、内容から計算した照合用の値です。Get-FileHashで求めたHashを、等しいか比べる記号の-eqで比較しています。これは今回の2ファイルの内容照合であり、バックアップ全体の完全性を保証するものではありません。

6.控えのコピーを保留へ移動し、名前を変える

移動・改名するのはコピー1件です。受け取りの元ファイルは残します。

Move-Itemはファイルを移動し、移動前の場所から対象をなくします。今回の移動先は保留です。不足する親フォルダーは自動作成されないため、節2で用意したフォルダーを使います。

Rename-Itemは、同じフォルダー内で名前を変える命令です。NewNameには新しい名前だけを指定します。今回は保留へ移した控え[3].txtを、確認済み[3].txtへ変更します。

  1. 次のコード欄の1行目、Test-Pathだけを実行し、保留がフォルダーとして存在するか確認します。
  2. Falseが出た場合やエラーが出た場合は、2行目以降を実行せず、準備を見直します。
  3. Trueを確認できた場合だけ、2行目から最後の名前表示までを実行します。途中でエラーが出たら、次の操作へ進まないでください。

コピーしたファイルだけを移動・改名する

Test-Path -LiteralPath $moveDir -PathType Container
$moved = Join-Path $moveDir '控え[3].txt'
Move-Item -LiteralPath $copied -Destination $moved -ErrorAction Stop
Test-Path -LiteralPath $copied
Test-Path -LiteralPath $moved -PathType Leaf
Rename-Item -LiteralPath $moved -NewName '確認済み[3].txt' -ErrorAction Stop
$renamed = Join-Path $moveDir '確認済み[3].txt'
(Get-Item -LiteralPath $renamed).Name

実行結果

True
False
True
確認済み[3].txt

出力はTrue、False、True、確認済み[3].txtの順です。最初は移動先フォルダーの存在、次のFalseは控えからコピーがなくなったこと、その次のTrueは保留にあることを示します。最後の名前で改名結果を確認できます。

移動・改名を戻す場合は、エクスプローラーでコピーを控えへ戻し、名前も控え[3].txtへ戻します。同名のファイルがある場合は上書きせず止めます。Ctrl+Cや画面を閉じる操作は、完了した移動の取消しにはなりません。

7.下位フォルダーを含めてテキストファイルを探す

検索を始める場所はLiteralPath、名前の条件はFilterで指定します。

準備で一覧を出したGet-ChildItemを、今度はファイルの検索に使います。Fileはファイルだけ、Recurseは下位フォルダーも調べる指定です。今回は練習フォルダーだけを対象にします。

Filterには、末尾が.txtの名前に合う条件を渡します。アスタリスクの*は任意の文字列に合う記号です。検索開始場所を文字どおり扱うLiteralPathと、名前の条件を扱うFilterは役割が異なります。

Sort-Object Nameで名前順に整え、Select-ObjectのExpandProperty Nameで名前の値だけを表示します。このコードは一覧を読むだけです。行末のパイプでつながっているため、3行全体を実行します。

ファイルだけを下位フォルダーから探す

Get-ChildItem -LiteralPath $lab -File -Recurse -Filter '*.txt' |
    Sort-Object Name |
    Select-Object -ExpandProperty Name

実行結果

メモ[3].txt
メモ3.txt
確認済み[3].txt

メモ[3].txt、メモ3.txt、確認済み[3].txtの3件が出ます。メモ3.txtは比較用の別ファイルで、追記・置換したメモ[3].txtとは区別します。並び順の細部は環境によって異なる場合があります。

実務の広い範囲を検索すると、所要時間やアクセス権の影響があります。今回の結果は$labが指す専用の練習領域でのものです。検索結果を削除へ渡す操作は行いません。

8.削除予告を表示し、対象がコピー1件か確認する

WhatIfは予定を表示する指定です。この段階では削除しません。

Remove-Itemは削除の命令で、ごみ箱からの復元は保証されません。まずWhatIfを付けて対象を確認します。予告が出たことだけで、実際の削除の成功や復元可能性が保証されるわけではありません。

今回の対象は、$renamedが指す保留の確認済み[3].txtです。実務ファイルへ変数を変更しないでください。実行前にエクスプローラーで練習場所を開き、受け取りに元ファイルが残っていることも確認します。

削除予告の案内は、PowerShell画面に表示されます。下の結果欄は通常出力だけを示しており、予告のパスや文言は含めていません。実際の案内は利用中の環境によって変わります。

練習場所を開くには、下の番号順にパスを表示して、エクスプローラーのアドレス欄へ渡します。$labの表示は場所を読むだけで、ファイルを移動・削除しません。

  1. 同じPowerShell画面の入力行に $lab と入力してEnterを押し、表示されたPSFilePracticeで始まるフォルダーのフルパスをコピーします。
  2. WindowsキーとEキーを押してエクスプローラーを開きます。上部のアドレス欄をクリックし、コピーしたパスを貼り付けてEnterを押します。右側の検索欄には入力しません。
  3. 受け取りを開き、元のメモ[3].txtが残っていることを確認します。元の練習場所へ戻って保留を開き、確認済み[3].txtがこの練習で作ったコピーであることも確認します。
  4. PowerShellへ戻り、次の「削除の予告」のコード欄だけを最後まで実行します。節9のコード欄は続けて貼り付けません。
  5. 通常出力に加え、PowerShell画面の削除予告に表示された場所と名前が、開いて確認した保留のコピー1件と一致するか確認します。

削除の予告を見て残っていることを確認する

Get-Content -LiteralPath $renamed -Encoding UTF8
Remove-Item -LiteralPath $renamed -WhatIf
Test-Path -LiteralPath $renamed -PathType Leaf

実行結果

replacement
True

replacementはコピーの内容、Trueは予告後もそのファイルが存在することを示します。WhatIfによってファイルが削除されたわけではありません。

画面の予告が、今回作った保留フォルダー内の確認済み[3].txtだけを指しているか確認します。別の場所や名前が表示された場合、または判断できない場合は、次の実削除へ進まず止めてください。

9.確認できたコピー1件だけを削除する

実削除後は、コピーがなくなったことと元が残ることの両方を確認します。

節8の予告に表示された対象が、練習で作ったコピーと一致している場合だけ進みます。次のコードは、その1件を実際に削除します。対象に迷う場合は、ここで止めてかまいません。

コード欄の末尾には、削除後の存在確認が2行あります。削除の1行だけで終えず、最後まで実行してコピーと元ファイルの状態を読み分けます。この例ではフォルダーの再帰削除や強制削除は行いません。

この練習で作ったコピー1件だけを削除する

Remove-Item -LiteralPath $renamed -ErrorAction Stop
Test-Path -LiteralPath $renamed
Test-Path -LiteralPath $file -PathType Leaf

実行結果

False
True

最初のFalseは、削除対象のコピーがなくなったことを示します。次のTrueは、受け取りの元ファイルが残っていることを示します。期待と異なる場合は、そのまま別のファイルを削除しないでください。

コピーを戻す必要がある場合は、残してある元ファイルからコピーし直します。同名ファイルがある場所へ上書きせず、別名や新しい練習場所を使います。同じ削除を繰り返して確認する必要はありません。

10.元の場所へ戻り、困ったときは新しい練習でやり直す

途中の状態を無理に修正せず、新しい練習フォルダーで掲載順にやり直します。

最後はSet-Locationで、最初の作業場所へ戻ります。コード欄の末尾まで実行すると、戻れたかを示す値と、今回の練習フォルダーの場所が表示されます。練習ファイルの自動削除は行いません。

移動・改名・削除の後に同じ行を繰り返すと、対象の状態が掲載順と異なります。下の表で症状を確認し、必要なら節2から新しい練習領域を作ります。画面を閉じて再開する場合は、変数が消えるため節1の版確認から進め直します。

症状 確認すること 次の行動
名前が違う/見つからない 角括弧とLiteralPath、変数が残っているか 同じ画面で準備から再開
コピー先がファイルになった コピー先が存在するフォルダーか 既存データを消さず、専用の新しい場所でやり直す
アクセスが拒否される 対象が自分の練習フォルダーか、使用中でないか 管理者起動やForceで回避せず、開いているアプリを確認
途中を再実行すると対象がない 移動・改名・削除を既に行ったか 新しい練習フォルダーで最初から順に実行

元の場所へ戻って練習領域を表示する

Set-Location -LiteralPath $start
(Get-Location).Path -eq $start
$lab

実行結果

True
(作成した練習フォルダーのパス)

Trueなら最初の作業場所へ戻れています。続くパスは今回作った練習フォルダーの場所で、環境ごとに異なります。エクスプローラーで内容を確認し、不要になった専用フォルダーだけを手動で片付けます。

この練習の到達点は、操作前後の存在・名前・内容を読み分けることです。ZIP圧縮、定期削除、共有フォルダーでの自動化は扱っていません。アクセス拒否や他のアプリによる使用中の状態も、この資料では実行していない範囲です。