Set-ItemProperty

구문

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

Set-ItemProperty
   [-Path] <String[]>
   -InputObject <PSObject>
   [-PassThru]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

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

Set-ItemProperty
   -LiteralPath <String[]>
   -InputObject <PSObject>
   [-PassThru]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Description

Set-ItemProperty cmdlet은 지정된 항목의 속성 값을 변경합니다. cmdlet을 사용하여 항목의 속성을 설정하거나 변경할 수 있습니다. 예를 들어 Set-ItemProperty 사용하여 파일 개체의 IsReadOnly 속성 값을 $True설정할 수 있습니다.

또한 Set-ItemProperty 사용하여 레지스트리 값과 데이터를 만들고 변경합니다. 예를 들어 키에 새 레지스트리 항목을 추가하고 해당 값을 설정하거나 변경할 수 있습니다.

예제

예제 1: 파일의 속성 설정

이 명령은 "final.doc" 파일의 IsReadOnly 속성 값을 "true"로 설정합니다. Path 사용하여 파일을 지정하고, 이름 속성의 이름을 지정하고, Value 매개 변수를 사용하여 새 값을 지정합니다.

파일은 System.IO.FileInfo 개체이며 IsReadOnly 속성 중 하나일 뿐입니다. 모든 속성을 보려면 Get-Item C:\GroupFiles\final.doc | Get-Member -MemberType Property입력합니다.

$true 자동 변수는 "TRUE" 값을 나타냅니다. 자세한 내용은 about_Automatic_Variables참조하세요.

Set-ItemProperty -Path C:\GroupFiles\final.doc -Name IsReadOnly -Value $true

예제 2: 레지스트리 항목 및 값 만들기

이 예제에서는 Set-ItemProperty 사용하여 새 레지스트리 항목을 만들고 항목에 값을 할당하는 방법을 보여줍니다. "HKLM\Software" 키의 "ContosoCompany" 키에 "NoOfEmployees" 항목을 만들고 해당 값을 823으로 설정합니다.

레지스트리 항목은 항목인 레지스트리 키의 속성으로 간주되므로 Set-ItemProperty 사용하여 레지스트리 항목을 만들고 해당 값을 설정하고 변경합니다.

첫 번째 명령은 레지스트리 항목을 만듭니다. 경로 사용하여 HKLM: 드라이브의 경로와 "Software\MyCompany" 키를 지정합니다. 이 명령은 이름 사용하여 항목 이름을 지정하고 값 값을 지정합니다.

두 번째 명령은 Get-ItemProperty cmdlet을 사용하여 새 레지스트리 항목을 확인합니다. Get-Item 또는 Get-ChildItem cmdlet을 사용하는 경우 항목이나 자식 항목이 아닌 키의 속성이므로 항목이 표시되지 않습니다.

세 번째 명령은 NoOfEmployees 항목의 값을 824로 변경합니다.

New-ItemProperty cmdlet을 사용하여 레지스트리 항목과 해당 값을 만든 다음 Set-ItemProperty 사용하여 값을 변경할 수도 있습니다.

HKLM: 드라이브에 대한 자세한 내용은 Get-Help Get-PSDrive입력합니다. PowerShell을 사용하여 레지스트리를 관리하는 방법에 대한 자세한 내용은 Get-Help Registry입력합니다.

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 823
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

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

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 824
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

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

예제 3: 파이프라인을 사용하여 항목 수정

이러한 명령은 파이프라인 연산자(|)를 사용하여 항목을 Set-ItemProperty보내는 방법을 보여 줍니다.

명령의 첫 번째 부분에서는 Get-ChildItem 사용하여 "Weekly.txt" 파일을 나타내는 개체를 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 파일 개체를 Set-ItemProperty보냅니다. Set-ItemProperty 명령은 Name 및 Value 매개 변수를 사용하여 속성과 새 값을 지정합니다.

이 명령은 InputObject 매개 변수를 사용하여 Get-ChildItem 가져오는 개체를 지정하는 것과 같습니다.

Get-ChildItem weekly.txt | Set-ItemProperty -Name IsReadOnly -Value $True

매개 변수

-Confirm

-Credential

-Exclude

-Filter

-Force

-Include

-InputObject

-LiteralPath

-Name

-PassThru

-Path

-UseTransaction

-Value

-WhatIf

입력

PSObject

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

출력

None, System.Management.Automation.PSCustomObject

이 cmdlet은 PassThru 매개 변수를 지정하는 경우 변경된 항목과 새 속성 값을 나타내는 PSCustomObject 개체를 생성합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

참고

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

관련 링크

• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• New-ItemProperty
• Remove-ItemProperty
• Rename-ItemProperty