Remove-ItemProperty

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

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

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 store.

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 (PS C:\>), it includes the fully qualified path of 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.

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

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\MyApp" subkey.

The second command uses Remove-ItemProperty to remove the "Options" registry value, and its data, from the "MyApp" subkey. Because Path is required, the command uses a dot ('.') to indicate the current ___location. It uses Name to specify which registry value to delete. It uses the Confirm parameter to request a user prompt before deleting the value.

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

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 Remove-ItemProperty. Then, it uses the Name parameter of Remove-ItemProperty to specify the name of the registry value.

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

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

You can pipe a string that contains a path, but not a literal path, to this cmdlet.

This cmdlet returns no output.

Windows PowerShell includes the following aliases for Remove-ItemProperty:

• rp

In the PowerShell Registry provider, registry values are considered to be properties of a registry key or subkey. You can use the ItemProperty cmdlets to manage these values.

Remove-ItemProperty is designed to work with the data exposed by any provider. To list the providers available in your session, type Get-PSProvider. For more information, see about_Providers.