Get-ItemProperty

구문

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]

Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [<CommonParameters>]

Description

Get-ItemProperty cmdlet은 지정된 항목의 속성을 가져옵니다. 예를 들어 이 cmdlet을 사용하여 파일 개체의 LastAccessTime 속성 값을 가져올 수 있습니다. 이 cmdlet을 사용하여 레지스트리 항목 및 해당 값을 볼 수도 있습니다.

예제

예제 1: 특정 디렉터리에 대한 정보 가져오기

이 명령은 "C:\Windows" 디렉터리에 대한 정보를 가져옵니다.

Get-ItemProperty C:\Windows

예제 2: 특정 파일의 속성 가져오기

이 명령은 "C:\Test\Weather.xls" 파일의 속성을 가져옵니다. 결과는 출력을 목록으로 표시하기 위해 Format-List cmdlet에 파이프됩니다.

Get-ItemProperty C:\Test\Weather.xls | Format-List

예제 3: 레지스트리 하위 키에 레지스트리 항목의 값 이름 및 데이터 표시

이 명령은 "CurrentVersion" 레지스트리 하위 키에 포함된 각 레지스트리 항목의 값 이름 및 데이터를 표시합니다. 명령에는 레지스트리의 "HKEY_LOCAL_MACHINE" 하이브에 매핑되는 HKLM:이라는 PowerShell 드라이브가 있어야 합니다. 해당 이름과 매핑이 있는 드라이브는 기본적으로 PowerShell에서 사용할 수 있습니다. 또는 공급자 이름 다음에 두 개의 콜론으로 시작하는 다음 대체 경로를 사용하여 이 레지스트리 하위 키의 경로를 지정할 수 있습니다.

"레지스트리::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

예제 4: 레지스트리 하위 키에서 레지스트리 항목의 값 이름 및 데이터 가져오기

이 명령은 "CurrentVersion" 레지스트리 하위 키에서 "ProgramFilesDir" 레지스트리 항목의 값 이름 및 데이터를 가져옵니다. 이 명령은 Path 매개 변수를 사용하여 하위 키를 지정하고 Name 매개 변수를 사용하여 항목의 값 이름을 지정합니다.

이 명령은 PowerShell 연속 문자인 백틱 또는 그레이브 악센트(')를 사용하여 두 번째 줄에서 명령을 계속합니다.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

예제 5: 레지스트리 키에서 레지스트리 항목의 값 이름 및 데이터 가져오기

이 명령은 "PowerShellEngine" 레지스트리 키에 있는 레지스트리 항목의 값 이름 및 데이터를 가져옵니다. 결과는 다음 샘플 출력에 표시됩니다.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

예제 6: 레지스트리 값 및 데이터의 결과 가져오기, 서식 지정 및 표시

이 예제에서는 목록에서 Get-ItemProperty 명령의 출력 형식을 지정하여 레지스트리 값과 데이터를 쉽게 볼 수 있도록 하고 결과를 쉽게 해석할 수 있도록 하는 방법을 보여줍니다.

첫 번째 명령은 Get-ItemProperty cmdlet을 사용하여 Microsoft.PowerShell 하위 키에서 레지스트리 항목을 가져옵니다. 이 하위 키는 PowerShell의 기본 셸에 대한 옵션을 저장합니다. 결과는 다음 샘플 출력에 표시됩니다.

출력에는 "Path" 및 "ExecutionPolicy"라는 두 개의 레지스트리 항목이 있음을 보여 줍니다. 레지스트리 키에 5개 미만의 항목이 포함된 경우 기본적으로 테이블에 표시되지만 목록에서 보기가 더 쉬운 경우가 많습니다.

두 번째 명령은 동일한 Get-ItemProperty 명령을 사용합니다. 그러나 이번에는 명령이 파이프라인 연산자(|)를 사용하여 명령 결과를 Format-List cmdlet으로 보냅니다. Format-List 명령은 값이 '*'(모두)인 Property 매개 변수를 사용하여 목록에 있는 개체의 모든 속성을 표시합니다. 결과는 다음 샘플 출력에 표시됩니다.

결과 표시에는 레지스트리 키 개체의 덜 익숙한 몇 가지 속성과 함께 "Path" 및 "ExecutionPolicy" 레지스트리 항목이 표시됩니다. PS 접두사인 다른 속성은 레지스트리 키를 나타내는 개체와 같은 PowerShell 사용자 지정 개체의 속성입니다.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

Path                                                        ExecutionPolicy
----                                                        ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe   RemoteSigned

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | Format-List -Property *

PSPath          : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath    : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName     : Microsoft.PowerShell
PSDrive         : HKLM
PSProvider      : Microsoft.PowerShell.Core\Registry
Path            : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned

매개 변수

-Credential

-Exclude

-Filter

-Include

-LiteralPath

-Name

-Path

-UseTransaction

입력

String

Get-ItemProperty경로가 포함된 문자열을 파이프할 수 있습니다.

출력

System.Boolean, System.String, System.DateTime

Get-ItemProperty 가져오는 각 항목 속성에 대한 개체를 반환합니다. 개체 형식은 검색되는 개체에 따라 달라집니다. 예를 들어 파일 시스템 드라이브에서 파일 또는 폴더를 반환할 수 있습니다.

참고

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

관련 링크

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