Move-ItemProperty
Moves a property from one location to another.
Move-ItemProperty [-Path*] <String[]> [-Destination*] <String> [-Name*] <String[]> [-Credential [<PSCredential>]][-Exclude [<String[]>]] [-Filter [<String>]] [-Force] [-Include [<String[]>]] [-PassThru] [-Confirm] [-WhatIf][-UseTransaction [<SwitchParameter>]] [<CommonParameters>]
Move-ItemProperty [-Destination*] <String> [-Name*] <String[]> [-Credential [<PSCredential>]] [-Exclude[<String[]>]] [-Filter [<String>]] [-Force] [-Include [<String[]>]] [-PassThru] -LiteralPath* <String[]> [-Confirm][-WhatIf] [-UseTransaction [<SwitchParameter>]] [<CommonParameters>]
The Move-ItemProperty cmdlet moves a property of an item from one item to another item. For instance, it can move a registry entry from one registry key to another registry key. When you move an item property, it is added to the new location and deleted from its original location.
Parameters |
---|
-Credential [<PSCredential>]
|
-Destination <String>
|
-Exclude [<String[]>]
|
-Filter [<String>]
|
-Force [<SwitchParameter>]
|
-Include [<String[]>]
|
-LiteralPath <String[]>
|
-Name <String[]>
|
-PassThru [<SwitchParameter>]
|
-Path <String[]>
|
-Confirm [<SwitchParameter>]
|
-WhatIf [<SwitchParameter>]
|
-UseTransaction [<SwitchParameter>]
|
<CommonParameters>
|
Inputs
System.String
You can pipe a string that contains a path to this cmdlet.
Outputs
None or System.Management.Automation.PSCustomObject
When you use the PassThru parameter, this cmdlet generates a PSCustomObject representing the moved item property. Otherwise, this cmdlet does not generate any output.
Examples
- Move a registry value and its data to another key:
PS C:> Move-ItemProperty "HKLM:SoftwareMyCompanyMyApp" -Name "Version" -Destination "HKLM:SoftwareMyCompanyNewApp"
This command moves the Version registry value, and its data, from the MyApp subkey to the NewApp subkey of the HKLMSoftwareMyCompany registry key.
Additional Notes
The names of the Path, Destination, and Name parameters are optional. If you omit the parameter names, the unnamed parameter values must appear in this order: Path, Destination, and Name. If you include the parameter names, the parameters can appear in any order. You can also refer to this cmdlet by its built-in alias, "mp". For more information, see about_Aliases. This cmdlet 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.
Related Links
Clear-ItemProperty
Copy-ItemProperty
Get-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty
Set-ItemProperty