Удаляет содержимое элемента без удаления самого элемента.

Синтаксис

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

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

Описание

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

Параметры

-Credential <PSCredential>

Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".

Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.

Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиком.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Exclude <string[]>

Исключает указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Filter <string>

Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Force

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Include <string[]>

Очищает только указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-LiteralPath <string[]>

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

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Path <string[]>

Задает путь к очищаемым элементам. Подстановочные знаки разрешены. Этот параметр обязателен, но его имя ("Path") можно не указывать.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

false

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-UseTransaction

Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.String

Можно передать строку пути командлету Clear-Item по конвейеру.

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

Нет

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

Примечания

Командлет Clear-Item поддерживается только несколькими поставщиками Windows PowerShell, включая поставщиков Alias, Environment, Function, Registry и Variable. Поэтому командлет Clear-Item можно использовать для удаления содержимого элементов в пространствах имен поставщиков.

Командлет Clear-Item нельзя использовать для удаления содержимого файла, так как он не поддерживается поставщиком Windows PowerShell FileSystem. Для очистки файлов используется командлет Clear-Content.

You can also refer to Clear-Item by its built-in alias, "cli". Чтобы получить дополнительные сведения, введите команду "Get-Help about_Aliases".

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

Пример 1

C:\PS>clear-item Variable:TestVar1

Описание
-----------
Эта команда удаляет значение переменной Testvar1. Переменная по-прежнему существует, однако ее значение равно Null. 
  
Имя переменной предваряется префиксом "Variable:" для указания того, что ее поставщиком является Windows PowerShell Variable. Аналогичный результат можно получить, переключившись в пространство имен поставщика Variable Windows PowerShell и выполнив команду Clear-Item.

	PS C:> Set-location Variable:
	PS Variable:\> clear-item Testvar1






Пример 2

C:\PS>clear-item Alias:log* -include *1* -exclude *3* -whatif

What if: Performing operation "Clear Item" on Target "Item: log1".

Описание
-----------
Эта команда спрашивает оболочку PowerShell о том, что произойдет при выполнении команды "clear-item alias:log* -include *1* -exclude *3". В ответ оболочка Windows PowerShell сообщает, что будет удалено значение псевдонима log1. 

Эта команда никак не повлияет на псевдонимы log, log2 и log13. Поставщик псевдонимов не допускает наличия псевдонимов без значений, поэтому при очистке псевдонима удаляется и сам псевдоним.






Пример 3

C:\PS>clear-item registry::HKLM\Software\MyCompany\MyKey -confirm

Описание
-----------
Эта команда удаляет все записи реестра из подраздела MyKey. Для этого необходимо ввести подтверждение. Эта команда не удаляет подраздел MyKey; другие разделы и записи реестра также не затрагиваются. Параметры Include и Exclude можно использовать для задания определенных разделов реестра, однако их нельзя использовать для задания записей реестра. Для удаления конкретных записей реестра используйте команду Remove-ItemProperty. Для удаления значения записи реестра используйте команду Clear-ItemProperty.






См. также