Clear-Item
Очищает содержимое элемента, но не удаляет его.
Синтаксис
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, который поддерживает использование фильтров. Синтаксис языка фильтра FileSystem можно найти в 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 |
Входные данные
Строку пути можно передать в этот командлет по конвейеру.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
PowerShell включает следующие псевдонимы для Clear-Item
:
Для всех платформ.
cli
Командлет
Clear-Item
поддерживается только несколькими поставщиками PowerShell, включая поставщики псевдонима, среды, функции, реестра и переменных . Таким образом, можно использовать дляClear-Item
удаления содержимого элементов в пространствах имен поставщика. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлетGet-PsProvider
. Дополнительные сведения см. в разделе about_Providers.Нельзя использовать для
Clear-Item
удаления содержимого файла, так как поставщик файловой системы PowerShell не поддерживает этот командлет. Чтобы очистить файлы, используйтеClear-Content
.