Remove-ItemProperty

Модуль:

Microsoft.PowerShell.Management Module

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

Синтаксис

Path (По умолчанию)

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

LiteralPath

Remove-ItemProperty
    [-Name] <String[]>
    -LiteralPath <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.

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

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". Так как требуется пути , команда использует точку ('.) для указания текущего расположения. Он использует имя, чтобы указать, какое значение реестра необходимо удалить. Он использует параметр Подтвердить, чтобы запросить запрос пользователя перед удалением значения.

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. Затем он использует параметр NameRemove-ItemProperty, чтобы указать имя значения реестра.

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

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

Замечание

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

Свойства параметров

Тип:	PSCredential
Default value:	Current user
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Exclude

Указывает элементы, которые этот командлет исключает. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешено использование подстановочных символов.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Filter

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

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

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Force

Принуждает командлет удалить свойство объекта, доступ к которому пользователь иначе не может получить. Реализация зависит от поставщика к поставщику. Дополнительные сведения см. в разделе о поставщиках.

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Include

Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешено использование подстановочных символов.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-LiteralPath

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	PSPath

Наборы параметров

LiteralPath

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Name

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False
Aliases:	PSProperty

Наборы параметров

(All)

Position:	1
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Path

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

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

Path

Position:	0
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-UseTransaction

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

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	usetx

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

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

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

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

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

None

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

Примечания

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

• rp

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

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

Связанные ссылки

• Get-Item
• Clear-ItemProperty
• Copy-ItemProperty (Копировать свойства элемента)
• Get-ItemProperty (Получить свойство элемента)
• Move-ItemProperty
• New-ItemProperty
• Удалить-Элемент
• Переименовать-СвойствоЭлемента
• Set-ItemProperty
• о_Поставщиках