PowerShell Logo Small

Remove-ItemProperty



This is the built-in help made by Microsoft for the command 'Remove-ItemProperty', in PowerShell version 2 - as retrieved from Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Deletes the property and its value from an item.

SYNTAX


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] [-Includ
e <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Remove-ItemProperty cmdlet deletes a property and its value from an item. You can use it to delete registry values and the data that they sto
re.



<

RELATED LINKS

Online version: http://go.microsoft.com/fwlink/?LinkID=113374
about_Providers
Clear-ItemProperty
Copy-ItemProperty
Get-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-Item
Rename-ItemProperty
Set-ItemProperty

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty



Description
-----------
This command deletes the SmpProperty registry value, and its data, from the SmpApplication subkey of the HKEY_LOCAL_MACHINE\Software registry key
.

Because the command is issued from a file system drive (C:\PS>), it includes the fully qualified path to the SmpApplication subkey, including the
drive, HKLM:, and the Software key.

It uses the Name parameter to identify the registry value that is being deleted.








-------------------------- EXAMPLE 2 --------------------------

C:\PS>set-location HKCU:\Software\MyCompany\MyApp

PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm



Description
-----------
These commands delete the Options registry value, and its data, from the MyApp subkey of HKEY_CURRENT_USER\Software\MyCompany.

The first command uses the Set-Location cmdlet to change the current location to the HKEY_CURRENT_USER drive (HKCU:) and the Software\MyCompany\M
yApp subkey.

The second command uses the Remove-Item cmdlet to remove the Options registry value, and its data, from the MyApp subkey. Because the Path parame
ter is required, the command uses a dot (.) to indicate the current location. It uses the Name parameter to specify which registry value to delet
e. It uses the Confirm parameter to request a user prompt before deleting the value.








-------------------------- EXAMPLE 3 --------------------------

C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees



Description
-----------
This command deletes the NoOfEmployees registry value, and its data, from the HKLM\Software\MyCompany registry key.

The command uses the Get-Item cmdlet to get an item that represents the registry key. It uses a pipeline operator (|) to send the object to the R
emove-ItemProperty cmdlet. Then, it uses the Name parameter of Remove-ItemProperty to specify the name of the registry value.