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 удаляет один или несколько элементов. Так как она поддерживается многими поставщиками, она может удалять различные типы элементов, включая файлы, папки, разделы реестра, переменные, псевдонимы и функции.

В этом примере удаляются все файлы с именами, включающими точку (.) из папки 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

Параметр пути используется для указания файла. Он использует параметр Force для его удаления. Без Forceневозможно удалить только для чтения или скрытые файлы.

Эта команда удаляет все CSV-файлы в текущей папке и все вложенные папки рекурсивно.

Так как параметр Recurse в Remove-Item имеет известная проблема, команда в этом примере использует Get-ChildItem для получения нужных файлов, а затем использует оператор конвейера для передачи их в Remove-Item.

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

В команде Get-ChildItem путь имеет значение (*), представляющее содержимое текущей папки. Он использует Include для указания типа CSV-файла и Recurse для рекурсивного извлечения. Если вы пытаетесь указать тип файла в пути, например -Path *.csv, командлет интерпретирует объект поиска как файл, который не содержит дочерних элементов, и рекурсия завершается ошибкой.

Эта команда удаляет ключ реестра "OldApp" и все его подразделы и значения. Он использует Remove-Item для удаления ключа. Указан путь, но отсутствует необязательное имя параметра (путь).

Параметр 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

В этом примере показано, как использовать динамический параметр stream Stream командлета Remove-Item для удаления альтернативного потока данных. Параметр потока представлен в 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'.

Параметр StreamGet-Item получает поток Zone.Identifier файла Copy-Script.ps1. 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. Дополнительные сведения см. в разделе о поставщиках.

При попытке удалить папку, содержащую элементы без использования параметра Recurse, командлет запрашивает подтверждение. Использование -Confirm:$false не подавляет запрос. Это сделано намеренно.