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 コマンドレットは、指定した項目の新しいプロパティを作成し、その値を設定します。 レジストリ値はレジストリ キー項目のプロパティであるため、通常、このコマンドレットを使用して新しいレジストリ値を作成します。

このコマンドレットは、オブジェクトにプロパティを追加しません。

• オブジェクトのインスタンスにプロパティを追加するには、Add-Member コマンドレットを使用します。
• 特定の型のすべてのオブジェクトにプロパティを追加するには、Types.ps1xml ファイルを変更します。

このコマンドは、NoOfEmployeesの MyCompany キーに新しいレジストリ エントリ (HKLM:\Software hive) を追加します。

最初のコマンドでは、Path パラメーターを使用して、MyCompany レジストリ キーのパスを指定します。 Name パラメーターを使用してエントリの名前を指定し、Value パラメーターを使用してその値を指定します。

2 番目のコマンドでは、Get-ItemProperty コマンドレットを使用して新しいレジストリ エントリを表示します。

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 コマンドレットを使用して、MyCompany レジストリ キーを取得します。 パイプライン演算子は、コマンドの結果を New-ItemPropertyに送信し、新しいレジストリ エントリ (NoOfLocations) とその値 (3) を MyCompany キーに追加します。

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

このコマンドは、PowerShell のパラメーター バインド機能により、 が返す Get-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

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットにオブジェクトをパイプすることはできません。

このコマンドレットは、新しいプロパティを表すカスタム オブジェクトを返します。

New-ItemProperty は、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。