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

Clear-Item

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

Очищает содержимое элемента, но не удаляет его.

Синтаксис

Clear-Item
     [-Path] <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Clear-Item очищает содержимое элемента, но не удаляет элемент. Например, Clear-Item командлет может удалить значение переменной, но не удаляет переменную. Значение, используемое для представления очищаемого элемента, определяется каждым поставщиком PowerShell. Этот командлет аналогичен Clear-Content, но он работает над псевдонимами и переменными, а не с файлами.

Примеры

Пример 1. Очистка значения переменной

Эта команда очищает значение переменной с именем TestVar1. Переменная остается допустимой, но ее значение имеет $nullзначение . Имя переменной имеет префикс, Variable: чтобы указать поставщик переменной PowerShell.

В альтернативных командах показано, что для получения того же результата можно переключиться на диск PowerShell Variable: , а затем выполнить Clear-Item команду.

Clear-Item Variable:TestVar1

Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

Пример 2. Очистка всех записей реестра

Эта команда очищает все записи реестра в подразделе MyKey, но только после запроса на подтверждение намерения. Он не удаляет подраздел "MyKey" или не влияет на другие разделы реестра или записи. Параметры Include и Exclude можно использовать для задания определенных разделов реестра, однако их нельзя использовать для задания записей реестра.

  • Чтобы удалить определенные записи реестра, используйте Remove-ItemProperty командлет.
  • Чтобы удалить значение записи реестра, используйте параметр Clear-ItemProperty cmdlet.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Параметры

-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

-Exclude

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

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

-Filter

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

Тип: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 не интерпретировать какие-либо символы как escape-последовательности.

Дополнительные сведения см. в 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

-WhatIf

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

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

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

String

Строку пути можно передать в этот командлет по конвейеру.

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

None

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

Примечания

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

  • Для всех платформ.

    • cli

  • Командлет Clear-Item поддерживается только несколькими поставщиками PowerShell, включая псевдоним, среду, функцию, реестр и поставщики переменных. Таким образом, можно удалить Clear-Item содержимое элементов в пространствах имен поставщика. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PsProvider. Дополнительные сведения см. в about_Providers.

  • Clear-Item Невозможно удалить содержимое файла, так как поставщик Файловой системы PowerShell не поддерживает этот командлет. Чтобы очистить файлы, используйте файл Clear-Content.