다음을 통해 공유


Get-ItemProperty

지정된 항목의 속성을 가져옵니다.

구문

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

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

설명

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

매개 변수

-Credential <PSCredential>

이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에 의해 생성된 것과 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.

이 매개 변수는 Windows PowerShell과 함께 설치된 어떤 공급자에서도 지원되지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Exclude <string[]>

지정된 항목을 생략합니다. 와일드카드를 사용할 수 있습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Filter <string>

공급자의 형식 또는 언어에 필터를 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 와일드카드 사용을 포함하여 필터의 구문은 공급자에 따라 다릅니다. 공급자는 개체를 검색한 후에 Windows PowerShell을 통해 해당 개체를 필터링하는 대신 개체를 검색할 때 필터를 적용하기 때문에 필터는 다른 매개 변수보다 훨씬 효율적입니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Include <string[]>

지정된 항목을 포함합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-LiteralPath <string[]>

항목 속성의 경로를 지정합니다. LiteralPath 값은 입력한 그대로 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 경로를 작은따옴표로 묶어야 합니다. 작은따옴표는 Windows PowerShell이 어떤 문자도 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Name <string[]>

검색할 하나 또는 여러 속성의 이름을 지정합니다.

필수 여부

false

위치

2

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Path <string[]>

하나 또는 여러 항목의 경로를 지정합니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

-UseTransaction

명령을 활성 트랜잭션에 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions를 참조하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.String

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

출력

Object

Get-ItemProperty에서 가져오는 각 항목 속성에 대한 개체가 반환됩니다. 개체 유형은 검색되는 개체에 따라 달라집니다.

참고

Get-ItemProperty cmdlet은 모든 공급자가 제공하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PSProvider"를 입력합니다. 자세한 내용은 about_Providers를 참조하십시오.

예 1

C:\PS>get-itemproperty C:\Windows

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





예 2

C:\PS>get-itemproperty C:\Test\Weather.xls | format-list

설명
-----------
이 명령은 C:\Test\Weather.xls 파일의 속성을 가져옵니다. 결과를 Format-List cmdlet으로 파이프하여 출력을 목록으로 표시합니다.





예 3

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

설명
-----------
이 명령은 CurrentVersion 레지스트리 하위 키에 포함된 각 레지스트리 항목의 값 이름과 데이터를 표시합니다. 이 명령에는 HKEY_LOCAL_MACHINE 레지스트리 하이브에 매핑되는 HKLM:이라는 Windows PowerShell 드라이브가 있어야 합니다. 이 이름을 가진 드라이브와 매핑은 Windows PowerShell에서 기본적으로 사용할 수 있습니다. 또는 두 개의 콜론이 뒤에 오는 공급자 이름으로 시작하는 대체 경로(Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion)를 사용하여 이 레지스트리 하위 키의 
경로를 지정할 수 있습니다.





예 4

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion `
-name "ProgramFilesDir"

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





예 5

C:\PS>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=31bf3856ad
                          364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

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





예 6

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

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


C:\PS>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

설명
-----------
이 예에서는 Get-ItemProperty 명령의 출력 형식을 목록으로 지정하여 레지스트리 값과 데이터를 알아보기 쉽게 표시하고 결과를 쉽게 해석하는 방법을 보여 줍니다.

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

출력에는 Path와 ExecutionPolicy라는 두 개의 레지스트리 항목이 있음이 표시됩니다. 레지스트리 키에 포함된 항목이 5개보다 적으면 기본적으로 테이블 형식으로 표시되지만 대개는 목록으로 표시되면 알아보기가 쉽습니다.

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

결과 표시에는 Path 및 ExecutionPolicy 레지스트리 항목과 함께 친숙하지 않은 몇 가지 레지스트리 키 개체 속성이 표시됩니다. 앞에 "PS"가 붙은 다른 속성은 Windows PowerShell 사용자 지정 개체, 예를 들어 레지스트리 키를 나타내는 개체의 속성입니다.





참고 항목

개념

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