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

Remove-ItemProperty

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Удаляет свойство и его значение из элемента.

Синтаксис

Remove-ItemProperty
      [-Path] <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]
Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Описание

Командлет Remove-ItemProperty удаляет свойство и его значение из элемента. Его можно использовать для удаления параметров реестра и их значений.

Примеры

Пример 1. Удаление значения реестра

Эта команда удаляет значение реестра SmpProperty и его данные из подраздела "SmpApplication" раздела реестра "HKEY_LOCAL_MACHINE\Software".

Так как команда выдается на диске файловой системы (PS C:\>), она включает полный путь к подразделу SmpApplication, включая диск, HKLM:и ключ Software.

Он использует параметр Name для идентификации значения реестра, которое удаляется.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

Пример 2. Удаление значения реестра из расположения HKCU

Эти команды удаляют значение реестра "Параметры" и его данные из подраздела "MyApp" раздела "HKEY_CURRENT_USER\Software\MyCompany".

Первая команда использует Set-Location командлет для изменения текущего расположения на диск HKEY_CURRENT_USER (HKCU:) и подраздел "Software\MyCompany\MyApp".

Вторая команда используется Remove-ItemProperty для удаления значения реестра "Параметры" и его данных из подраздела "MyApp". Так как путь является обязательным, команда использует точку ('.) для указания текущего расположения. Он использует имя для указания значения реестра для удаления. Он использует параметр Confirm для запроса запроса пользовательского запроса перед удалением значения.

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

Пример 3. Удаление значения реестра с помощью конвейера

Эта команда удаляет значение реестра NoOfEmployees и его данные из раздела реестра HKLM\Software\MyCompany.

Команда использует Get-Item командлет для получения элемента, представляющего раздел реестра. Он использует оператор конвейера (|) для отправки объекта Remove-ItemPropertyв . Затем он использует параметр Name для Remove-ItemProperty указания имени значения реестра.

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

Параметры

-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». Можно использовать подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Filter

Задает фильтр в формате или языке поставщика. Значение этого параметра определяет параметр Path.

Синтаксис фильтра, включая использование подстановочных знаков, зависит от поставщика. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не фильтрует объекты После их получения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Force

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

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-LiteralPath

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

Тип:String[]
Aliases:PSPath
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имена удаляемых свойств. Можно использовать подстановочные знаки.

Тип:String[]
Aliases:PSProperty
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Path

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

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-UseTransaction

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

Тип:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

Можно передать строку, содержащую путь, но не литеральный путь к этому командлету.

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

None

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

Примечания

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

  • rp

В поставщике реестра PowerShell значения реестра считаются свойствами раздела реестра или подраздела. Для управления этими значениями можно использовать командлеты ItemProperty .

Remove-ItemProperty предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PSProvider. Дополнительные сведения см. в about_Providers.