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
A dynamic parameter that is only available in registry drives.
Can also be given using the alias '-type'
Values:
String A null-terminated string. A REG_SZ registry Data Type.
ExpandString A null-terminated string that contains unexpanded references to environment variables that
are expanded when the value is retrieved. A REG_EXPAND_SZ registry Data Type.
Binary Binary data in any form. A REG_BINARY registry Data Type.
DWord A 32-bit binary number. [Default]. A REG_DWORD registry Data Type.
MultiString An array of null-terminated strings terminated by two null characters.
A REG_MULTI_SZ registry Data Type.
Qword A 64-bit binary number. A REG_QWORD registry Data Type.
Unknown An unsupported registry Data Type, such as REG_RESOURCE_LIST.
-value Object
The value to be set.
-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. "*windevcluster*"
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.
All the options of the New-ItemProperty cmdlet are also available in Set-ItemProperty
Add a new integer property named "Demo" stored in HKLM\Software\windevclusterApp:
PS C:\> Set-Location hklm:\software
PS HKLM:\Software> New-Item windevclusterApp
PS HKLM:\Software> New-ItemProperty windevclusterApp -name Demo -Type int -Value 1
“All good things are wild and free” ~ Henry David Thoreau
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.