New-ItemProperty

Syntax

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

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

Description

cmdlet은 New-ItemProperty 지정된 항목에 대한 새 속성을 만들고 해당 값을 설정합니다. 레지스트리 값은 레지스트리 키 항목의 속성이기 때문에 일반적으로 이 cmdlet은 새 레지스트리 값을 만드는 데 사용됩니다.

이 cmdlet은 개체에 속성을 추가하지는 않습니다.

• 개체의 instance 속성을 추가하려면 cmdlet을 Add-Member 사용합니다.
• 특정 형식의 모든 개체에 속성을 추가하려면 Types.ps1xml 파일을 수정합니다.

예제

예제 1: 레지스트리 항목 추가

이 명령은 의 키HKLM:\Software hive에 새 레지스트리 항목 를 NoOfEmployeesMyCompany 추가합니다.

첫 번째 명령은 Path 매개 변수를 사용하여 레지스트리 키의 MyCompany 경로를 지정합니다. Name 매개 변수를 사용하여 항목의 이름을 지정하고 Value 매개 변수를 사용하여 해당 값을 지정합니다.

두 번째 명령은 cmdlet을 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

예제 2: 키에 레지스트리 항목 추가

이 명령은 새 레지스트리 항목을 레지스트리 키에 추가합니다. 키를 지정하기 위해 파이프라인 연산자(|)를 사용하여 키를 New-ItemProperty나타내는 개체를 에 보냅니다.

명령의 첫 번째 부분에서는 cmdlet을 Get-Item 사용하여 레지스트리 키를 가져옵니다 MyCompany . 파이프라인 연산자는 명령New-ItemProperty의 결과를 에 보내 새 레지스트리 항목() 및 해당 값(NoOfLocations3)을 키에 MyCompany 추가합니다.

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

이 명령은 PowerShell의 매개 변수 바인딩 기능이 반환되는 RegistryKey 개체 Get-Item 의 경로를 의 LiteralPath 매개 변수 New-ItemProperty와 연결하기 때문에 작동합니다. 자세한 내용은 about_Pipelines.

예제 3: Here-String 사용하여 레지스트리에서 MultiString 값 Create

이 예제에서는 MultiString Here-String을 사용하여 값을 만듭니다.

$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

예제 4: 배열을 사용하여 레지스트리에서 MultiString 값 Create

이 예제에서는 값 배열을 사용하여 값을 만드는 MultiString 방법을 보여줍니다.

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

a

매개 변수

-Confirm

-Credential

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Name

-Path

-PropertyType

-Value

-WhatIf

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

PSCustomObject

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

참고

New-ItemProperty 는 모든 공급자가 노출하는 데이터와 함께 작동하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 를 입력합니다 Get-PSProvider. 자세한 내용은 about_Providers를 참조하세요.

관련 링크

• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• Remove-ItemProperty
• Rename-ItemProperty
• Set-ItemProperty
• about_Providers