Remove-Item

Remove-Item
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-Stream <String[]>]
    [<CommonParameters>]

Remove-Item
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-Stream <String[]>]
    [<CommonParameters>]

Remove-Item
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-DeleteKey]
    [<CommonParameters>]

Remove-Item
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-DeleteKey]
    [<CommonParameters>]

Remove-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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

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

Remove-Item C:\Test\*.*

次の使用例は、現在のフォルダーから、 .doc ファイル拡張子と *1*を含まない名前を持つすべてのファイルを削除します。

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

ワイルドカード文字 (*) を使用して、現在のフォルダーの内容を指定します。 Include パラメータと Exclude パラメータを使用して、削除するファイルを指定します。

このコマンドは、 非表示 と 読み取り専用の両方のファイルを削除します。

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

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

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

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

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

Get-ChildItem コマンドの Path の値は (*)、現在のフォルダーの内容を表します。 Include を使用して CSV ファイルの種類を指定し、Recurse を使用して取得を再帰的にします。 -Path *.csvなど、パスにファイルの種類を指定しようとすると、コマンドレットは検索の件名を子項目のないファイルと解釈し、再帰が失敗します。

このコマンドは、"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 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'.

Stream パラメーター Get-Itemは、Copy-Script.ps1 ファイルのZone.Identifier ストリームを取得します。 Remove-Item では、 Stream パラメーターを使用して、ファイルの Zone.Identifier ストリームを削除します。 最後に、 Get-Item コマンドレットは、 Zone.Identifier ストリームが削除されたことを示します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

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

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

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

• すべてのプラットフォーム:
  • del
  • erase
  • rd
  • ri
• ウィンドウズ：
  • rm
  • rmdir

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

Recurse パラメーターを使用せずにアイテムを含むフォルダーを削除しようとすると、コマンドレットによって確認が求められます。 -Confirm:$falseを使用しても、プロンプトは抑制されません。 これは仕様です。