New-ItemProperty

New-ItemProperty
    [-Path] <String[]>
    [-Name] <String>
    [-PropertyType <String>]
    [-Value <Object>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-ItemProperty
    [-Name] <String>
    -LiteralPath <String[]>
    [-PropertyType <String>]
    [-Value <Object>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-ItemProperty cmdlet 为指定项创建新属性并设置其值。 通常，此 cmdlet 用于创建新的注册表值，因为注册表值是注册表项项的属性。

此 cmdlet 不会向对象添加属性。

• 若要将属性添加到对象的实例，请使用 Add-Member cmdlet。
• 若要向特定类型的所有对象添加属性，请修改 Types.ps1xml 文件。

此命令将新的注册表项 NoOfEmployees添加到 MyCompany的 HKLM:\Software hive 键。

第一个命令使用 Path 参数指定 MyCompany 注册表项的路径。 它使用 Name 参数指定条目的名称，Value 参数指定其值。

第二个命令使用 Get-ItemProperty cmdlet 查看新的注册表项。

New-ItemProperty -Path "HKLM:\Software\MyCompany" -Name "NoOfEmployees" -Value 822
Get-ItemProperty "HKLM:\Software\MyCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 822

此命令将新的注册表项添加到注册表项。 若要指定密钥，它使用管道运算符（|）发送表示要 New-ItemProperty键的对象。

命令的第一部分使用 Get-Item cmdlet 来获取 MyCompany 注册表项。 管道运算符将命令的结果发送到 New-ItemProperty，该命令会将新注册表项（NoOfLocations）及其值（3）添加到 MyCompany 键。

Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3

此命令的工作原理是，PowerShell 的参数绑定功能将 RegistryKeyGet-Item 对象的路径与 New-ItemProperty 参数相关联。 有关详细信息，请参阅 about_Pipelines。

此示例使用 Here-String 创建 MultiString 值。

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'HereString' -PropertyType MultiString -Value @"
This is text which contains newlines
It can also contain "quoted" strings
"@
$newValue.multistring

This is text which contains newlines
It can also contain "quoted" strings

该示例演示如何使用值数组来创建 MultiString 值。

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]

a

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

此 cmdlet 返回一个表示新属性的自定义对象。

New-ItemProperty 被设计用于处理任何供应商公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。