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.HereString

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。