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

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Примечание

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

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

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

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

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Указывает путь к очищаемым элементам. Можно использовать подстановочные знаки. Этот параметр является обязательным, но имя параметра Path является необязательным.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

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

None

Этот командлет не формирует никаких выходных данных.

Примечания

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