Удаляет свойство элемента и его значение.
Синтаксис
Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Remove-ItemProperty удаляет свойство элемента и его значение. Его можно использовать для удаления параметров реестра и их значений.
Параметры
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.
Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиком.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Exclude <string[]>
Исключает указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Filter <string>
Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Force
Позволяет командлету удалить свойство объекта, которое было бы недоступно пользователю другими способами. Реализация варьируется от поставщика к поставщику. Дополнительные сведения см. в разделе About_Providers.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Include <string[]>
Удаляет только указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-LiteralPath <string[]>
Задает путь к свойству элемента. Значение параметра LiteralPath используется точно в том виде, в котором оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь включает escape-символы, его нужно заключить в одиночные кавычки. Одиночные кавычки указывают оболочке Windows PowerShell, что никакие символы не следует интерпретировать как escape-символы.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Name <string[]>
Задает имена извлекаемых свойств.
|
Обязательно? |
true |
|
Позиция? |
2 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Path <string[]>
Задает путь к элементу, свойства которого удаляются. Подстановочные знаки разрешены.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue, ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Строку, содержащую путь (но не литеральный путь), можно передать командлету Remove-ItemProperty по конвейеру. |
|
Выходные данные |
Нет Этот командлет не возвращает никаких выходных данных. |
Примечания
Командлет Remove-ItemProperty также можно вызывать с помощью встроенного псевдонима "rp". Чтобы получить дополнительные сведения, см. раздел about_Alias.
При работе с поставщиком реестра Windows PowerShell параметры реестра считаются свойствами разделов и вложенных разделов реестра. Для работы с этими параметрами можно использовать командлеты ItemProperty.
Командлет Remove-ItemProperty предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PSProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty Описание ----------- Эта команда удаляет значение реестра SmpProperty и его данные из подраздела SmpApplication раздела "HKEY_LOCAL_MACHINE\Software". Так как команда запускается с диска файловой системы (C:\PS>), она включает полный путь к подразделу SmpApplication, включая диск HKLM: и раздел Software. Для задания удаляемого параметра реестра используется параметр Name.
Пример 2
C:\PS>set-location HKCU:\Software\MyCompany\MyApp PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm Описание ----------- Данные команды удаляют параметр реестра Options и его значение из вложенного раздела MyApp раздела HKEY_CURRENT_USER\Software\MyCompany. Первая команда с помощью командлета Set-Location изменяет текущее местоположение на раздел Software\MyCompany\MyApp на диске HKEY_CURRENT_USER (HKCU:). Вторая команда использует командлет Remove-Item для удаления параметра реестра Options и его значения из вложенного раздела MyApp. Так как параметр Path является обязательным, то в команде используется точка (.) для задания текущего местоположения. Для задания удаляемого параметра реестра используется параметр Name. Для подтверждения на удаление параметра используется параметр Confirm.
Пример 3
C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees Описание ----------- Эта команда удаляет значение реестра NoOfEmployees и его данные из раздела "HKLM\Software\MyCompany". С помощью командлета Get-Item эта команда получает элемент, представляющий раздел реестра. Объект передается командлету Remove-ItemProperty с помощью оператора конвейера (|). Для задания имени значения реестра используется параметр Name командлета Remove-ItemProperty.