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, поддерживающий использование фильтров. Синтаксис языка фильтра FileSystem можно найти в about_Wild карта. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не фильтрует объекты После их получения.

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

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

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

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

Примечания

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

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

    • cli

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

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