Remove-Item

Remove-Item コマンドレットは、1 つ以上のアイテムを削除します。 多くのプロバイダーでサポートされているため、ファイル、フォルダー、レジストリ キー、変数、エイリアス、関数など、さまざまな種類のアイテムを削除できます。

このコマンドは、名前にドット ('.') を含むすべてのファイルを "C:\Test" フォルダから削除します。 このコマンドではドットが指定されているため、ファイル名拡張子のないフォルダーやファイルは削除されません。

Remove-Item C:\Test\*.*

このコマンドは、ファイル名拡張子が ".doc" で、名前が 1 を含まないすべてのファイルを現在のフォルダから削除します。 ワイルドカード文字 ('*') を使用して、現在のフォルダの内容を指定します。 Include パラメータと Exclude パラメータを使用して、削除するファイルを指定します。

Remove-Item * -Include *.doc -Exclude *1*

このコマンドは、 非表示 で 読み取り専用のファイルを削除します。 Path パラメーターを使用してファイルを指定します。 Force パラメータを使用して削除します。 Force を使用しない場合、読み取り専用ファイルや隠しファイルを削除することはできません。

Remove-Item -Path C:\Test\hidden-RO-file.txt -Force

このコマンドは、現在のフォルダとすべてのサブフォルダ内のすべての CSV ファイルを再帰的に削除します。

の Remove-Item パラメーターには既知の問題があるため、この例のコマンドでは Get-ChildItem を使用して目的のファイルを取得し、パイプライン演算子を使用してそれらを Remove-Item に渡します。

Get-ChildItem コマンドでは、Path の値は '*' で、これは現在のフォルダの内容を表します。 Include を使用して CSV ファイルの種類を指定し、Recurse を使用して取得を再帰的にします。

ファイルの種類 ( -Path *.csv など) をパスに指定しようとすると、コマンドレットは検索の件名を子項目がないファイルと解釈し、 Recurse は失敗します。

Get-ChildItem * -Include *.csv -Recurse | Remove-Item

このコマンドは、"OldApp" レジストリ キーとそのすべてのサブキーと値を削除します。 Remove-Itemを使用してキーを削除します。 パスは指定されていますが、オプションのパラメーター名 (Path) は省略されています。

Recurse パラメーターは、"OldApp" キーのすべての内容を再帰的に削除します。 キーにサブキーが含まれている場合に Recurse パラメータを省略すると、キーの内容を削除することを確認するように求められます。

Remove-Item HKLM:\Software\MyCompany\OldApp -Recurse

次の例は、角かっこや括弧などの特殊文字を含むファイルを削除する方法を示しています。

Get-ChildItem

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         6/1/2018  12:19 PM           1362 myFile.txt
-a----         6/1/2018  12:30 PM           1132 myFile[1].txt
-a----         6/1/2018  12:19 PM           1283 myFile[2].txt
-a----         6/1/2018  12:19 PM           1432 myFile[3].txt

Get-ChildItem | Where-Object Name -Like '*`[*'

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         6/1/2018  12:30 PM           1132 myFile[1].txt
-a----         6/1/2018  12:19 PM           1283 myFile[2].txt
-a----         6/1/2018  12:19 PM           1432 myFile[3].txt

Get-ChildItem | Where-Object Name -Like '*`[*' | ForEach-Object { Remove-Item -LiteralPath $_.Name }
Get-ChildItem

Directory: C:\temp\Downloads

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         6/1/2018  12:19 PM           1362 myFile.txt

この例では、 Remove-Item コマンドレットの Stream 動的パラメーターを使用して、代替データ ストリームを削除する方法を示します。 stream パラメーターは、Windows PowerShell 3.0 で導入されました。

最初のコマンドでは、 コマンドレットの Get-Item 動的パラメーターを使用して、"Copy-Script.ps1" ファイルの Zone.Identifier ストリームを取得します。

2 番目のコマンドは、 コマンドレットの Remove-Item 動的パラメーターを使用して、ファイルの Zone.Identifier ストリームを削除します。

3 番目のコマンドでは、 コマンドレットの Get-Item 動的パラメーターを使用して、Zone.Identifier ストリームが削除されていることを確認します。

4 番目のコマンドは Get-Item ファイルが削除されていないことを確認するために Stream パラメーターを指定せずにコマンドレットを実行します。

Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

FileName: \\C:\Test\Copy-Script.ps1

Stream                   Length
------                   ------
Zone.Identifier              26

Remove-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

Get-Item : Could not open alternate data stream 'Zone.Identifier' of file 'C:\Test\Copy-Script.ps1'.
At line:1 char:1
+ Get-Item 'C:\Test\Copy-Script.ps1' -Stream Zone.Identifier
+ [!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()][!INCLUDE[]()]~~
    + CategoryInfo          : ObjectNotFound: (C:\Test\Copy-Script.ps1:String) [Get-Item], FileNotFoundE
   xception
    + FullyQualifiedErrorId : AlternateDataStreamNotFound,Microsoft.PowerShell.Commands.GetItemCommand

Get-Item C:\Test\Copy-Script.ps1

Directory: C:\Test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---          8/4/2011  11:15 AM       9436 Copy-Script.ps1

String

文字列に含まれるパスは、このコマンドレットにパイプできますが、リテラル パスはパイプできません。

None

このコマンドレットによる戻り値はありません。

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