New-ItemProperty

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:

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


© Copyright SS64.com 1999-2013
Some rights reserved