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. Разрешены подстановочные знаки. Параметр Исключить действует только в том случае, если команда включает содержимое элемента, например 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

Указывает путь к элементам, которые очищаются. Разрешены подстановочные знаки. Этот параметр является обязательным, но имя параметра 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.