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

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

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

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

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

-Filter

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

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

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

-Force

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

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

-Include

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

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

-LiteralPath

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

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

-Name

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

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

-Path

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

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

-UseTransaction

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

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

-WhatIf

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

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

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

String

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

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

None

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

Примечания

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

  • rp

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

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