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 파일을 수정합니다.

이 명령은 NoOfEmployeesMyCompany 키에 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의 매개 변수 바인딩 기능이 반환하는 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

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

이 cmdlet은 새 속성을 나타내는 사용자 지정 개체를 반환합니다.

New-ItemProperty 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PSProvider입력합니다. 추가 정보는 about_Providers를 참조하십시오.