Поделиться через

Remove-Item

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Удаляет указанные элементы.

Синтаксис

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\*.*

Пример 2. Удаление файлов документов в папке

В этом примере удаляются из текущей папки все файлы, имеющие расширение .doc файла, и имя, которое не содержит *1*.

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

Он использует подстановочный знак (*) для указания содержимого текущей папки. В нем используются параметры include и Exclude, чтобы указать файлы для удаления.

Пример 3. Удаление скрытых, доступных только для чтения файлов

Эта команда удаляет файл, который скрытые и только для чтения.

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

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

Пример 4. Удаление файлов в вложенных папках рекурсивно

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

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

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

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

Заметка

Это поведение было исправлено в Windows версии 1909 и более поздних версий.

Пример 5. Рекурсивно удалите вложенные ключи

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

Параметр Recurse удаляет все содержимое ключа OldApp рекурсивно. Если ключ содержит вложенные ключи и вы опустите параметр Recurse, вам будет предложено подтвердить, что вы хотите удалить содержимое ключа.

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

Пример 6. Удаление файлов со специальными символами

В следующем примере показано, как удалить файлы, содержащие специальные символы, такие как квадратные скобки или круглые скобки.

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

Пример 7. Удаление альтернативного потока данных

В этом примере показано, как использовать динамический параметр 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 был удален.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета. Дополнительные сведения см. в следующих статьях:

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Credential

Заметка

Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить свои учетные данные при выполнении этого командлета, используйте Invoke-Command.

Тип:PSCredential
Position:Named
Default value:Current user
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DeleteKey

Это динамический параметр, доступный поставщиком сертификатов . Поставщик сертификата и этот параметр доступны только на платформах Windows.

Когда это указано, командлет удаляет закрытый ключ при удалении сертификата.

Для получения дополнительной информации см. about_Certificate_Provider.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Exclude

Указывает как строковый массив, элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например *.txt. Разрешено использование подстановочных символов. Параметр Исключить действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

При использовании рекурсии с исключить, исключить фильтрует только результаты текущего каталога. Если в вложенных папках есть файлы, соответствующие шаблону исключить, эти файлы удаляются вместе с родительским каталогом.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Filter

Указывает фильтр для квалификации параметра Path. Поставщик файловой системы является единственным установленным поставщиком PowerShell, поддерживающим использование фильтров. Синтаксис для языка фильтрации файловой системы можно найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, поскольку поставщик применяет их, когда командлет получает объекты, а не когда PowerShell фильтрует объекты после их получения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Force

Позволяет командлету удалять элементы, которые не могут быть изменены, например скрытые или доступные только для чтения файлы или псевдонимы только для чтения или переменные. Командлет не может удалить константные псевдонимы или переменные. Реализация зависит от поставщика к поставщику. Дополнительные сведения см. в разделе about_Providers. Даже при использовании параметра Force командлет не может обойти ограничения безопасности.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешено использование подстановочных символов. Параметр Include действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-LiteralPath

Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется точно так, как введено. Символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки указывают PowerShell не интерпретировать любые символы как управляющие последовательности.

Дополнительные сведения см. в about_Quoting_Rules.

Тип:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Path

Указывает путь к удаленным элементам. Разрешено использование подстановочных символов.

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Recurse

Указывает, что этот командлет удаляет элементы в указанных расположениях и во всех дочерних элементах расположений.

Возможно, параметр Recurse не удаляет все вложенные папки или все дочерние элементы. Это известная проблема.

Заметка

Это поведение было исправлено в Версиях Windows 1909 и более поздних версиях.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Stream

Это динамический параметр, доступный поставщиком файловой системы. Этот параметр доступен только в Windows. Этот параметр нельзя использовать в сочетании с параметром Recurse.

Можно использовать Remove-Item для удаления альтернативного потока данных, например Zone.Identifier. Однако это не рекомендуется для устранения проверок безопасности, которые блокируют файлы, скачанные из Интернета. Если убедиться, что скачанный файл является безопасным, используйте командлет Unblock-File.

Этот параметр появился в Windows PowerShell 3.0. По состоянию на Windows PowerShell 7.2 Remove-Item могут удалять альтернативные потоки данных из каталогов, а также файлов.

Дополнительные сведения см. в about_FileSystem_Provider.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-WhatIf

Показывает, что произойдет, если командлет будет выполняться. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

Можно передать строку, содержащую путь, но не литеральный путь к этому командлету.

Выходные данные

None

Этот командлет не возвращает выходные данные.

Примечания

PowerShell включает следующие псевдонимы для Remove-Item:

  • Все платформы:
    • del
    • erase
    • rd
    • ri
  • Виндоус:
    • rm
    • rmdir

Командлет Remove-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе about_Providers.

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