Set a new property, for an item at a given location.
Syntax
New-ItemProperty { [-path] string[] | [-literalPath] string[] }
[[-name] string[]] [-propertyType string] [-value Object]
[-include string[]] [-exclude string[]]
[-filter string] [-force] [-credential PSCredential]
[-whatIf] [-confirm] [-UseTransaction] [CommonParameters]
Key
-path string
The path(s) to the item for which a new property is to be created.
Wildcards are permitted.
-literalPath string
Like Path above, only the value is used exactly as typed.
No characters are interpreted as wildcards. If the path includes any
escape characters then enclose the path in single quotation marks.
-name string
The name of the property to create.
-propertyType string
The Type of the property.
-value Object
The Value of the property.
-include string
Include only the specified items from the Path. e.g. "May*"
this only works when the path includes a wildcard character.
-exclude string
Omit the specified items from the Path e.g. "*SS64*"
this only works when the path includes a wildcard character.
-filter string
A filter in the provider's format or language.
The exact syntax of the filter (wildcard support etc) depends on the provider.
Filters are more efficient than -include/-exclude, because the provider
applies the filter when retrieving the objects, rather than having
PowerShell filter the objects after they are retrieved.
-force
Override restrictions such as renaming existing files as long
as security is not compromised.
-credential PSCredential
Use a credential to validate access to the file. Credential represents
a user-name, such as "User01" or "Domain64\User64", or a PSCredential
object, such as the one retrieved by using the Get-Credential cmdlet.
If you type a user name, you will be prompted for a password.
-whatIf
Describe what would happen if you executed the command without
actually executing the command.
-confirm
Prompt for confirmation before executing the command.
-UseTransaction
Include the command in the active transaction.
CommonParameters:
-Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
-OutBuffer -OutVariable.
Examples
Add a new int property named "Demo" to HKLM\Software\SS64App:
PS HKLM:\Software> new-itemproperty SS64App -name Demo -Type int -Value 1
Disable UAC (User Account Control)
PS HKLM:\> New-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System" -Name "ConsentPromptBehaviorAdmin" -Value 00000000 -PropertyType "DWord"
“All good things are wild and free” ~ Henry David Thoreau
Related PowerShell Cmdlets:
Clear-ItemProperty - Delete the value of a property.
Copy-ItemProperty - Copy a property along with its value.
Get-ItemProperty - Retrieve the properties of an object.
Move-ItemProperty - Move a property from one location to another.
New-Item - Create a new item in a namespace.
Remove-ItemProperty - Delete the property and its value from an item.
Rename-ItemProperty - Rename a property of an item.
Set-ItemProperty - Set the value of a property.