Get-Item
지정된 위치에 있는 항목을 가져옵니다.
구문
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Description
Get-Item
cmdlet은 지정된 위치에 있는 항목을 가져옵니다.
와일드카드 문자('*')를 사용하여 항목의 모든 내용을 요청하지 않는 한 해당 위치에서 항목의 내용을 가져올 수 없습니다.
이 cmdlet은 PowerShell 공급자가 다양한 유형의 데이터 저장소를 탐색하는 데 사용됩니다.
예제
예제 1: 현재 디렉터리 가져오기
이 명령은 현재 디렉터리를 가져옵니다. 점('.')은 현재 위치에 있는 항목을 나타냅니다(내용이 아님).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
예제 2: 현재 디렉터리의 모든 항목 가져오기
이 명령은 현재 디렉터리의 모든 항목을 가져옵니다. 와일드카드 문자('*')는 현재 항목의 모든 내용을 나타냅니다.
Get-Item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
예제 3: 드라이브의 현재 디렉터리 가져오기
이 명령은 C: 드라이브의 현재 디렉터리를 가져옵니다. 검색되는 개체는 해당 내용이 아닌 디렉터리만 나타냅니다.
Get-Item C:\
예제 4: 지정된 드라이브의 항목 가져오기
이 명령은 C: 드라이브의 항목을 가져옵니다. 와일드카드 문자('*')는 컨테이너뿐만 아니라 컨테이너의 모든 항목을 나타냅니다.
PowerShell에서 기존의 "대신 단일 별표('
Get-Item C:\*
예제 5: 지정된 디렉터리에서 속성 가져오기
이 명령은 "C:\Windows" 디렉터리의 LastAccessTime 속성을 가져옵니다.
LastAccessTime 파일 시스템 디렉터리 중 하나의 속성에 불과합니다.
디렉터리의 모든 속성을 보려면 (Get-Item \<directory-name\>) | Get-Member
입력합니다.
(Get-Item C:\Windows).LastAccessTime
예제 6: 레지스트리 키의 내용 표시
이 명령은 Microsoft.PowerShell 레지스트리 키의 내용을 보여 줍니다.
이 cmdlet을 PowerShell 레지스트리 공급자와 함께 사용하여 레지스트리 키 및 하위 키를 가져올 수 있지만 Get-ItemProperty
cmdlet을 사용하여 레지스트리 값과 데이터를 가져와야 합니다.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
예제 7: 제외가 있는 디렉터리의 항목 가져오기
이 명령은 점('.')을 포함하지만 "w*"로 시작하지 않는 이름을 가진 Windows 디렉터리의 항목을 가져옵니다. 이 명령은 경로에 와일드카드 문자('*')가 포함되어 항목의 내용을 지정하는 경우에만 작동합니다.
Get-Item c:\Windows\*.* -Exclude "w*"
매개 변수
-Credential
이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential
cmdlet에서 생성된 개체와 같은 PSCredential 개체를 입력합니다.
사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.
경고
이 매개 변수는 Windows PowerShell과 함께 설치된 공급자에서 지원되지 않습니다.
형식: | PSCredential |
Position: | Named |
Default value: | Current user |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Exclude
문자열 배열로 이 cmdlet이 작업에서 제외하는 항목 또는 항목을 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: "*.txt")을 입력합니다. 와일드카드 문자가 허용됩니다.
Exclude 매개 변수는 명령이 "C:\Windows*"와 같은 항목의 내용을 포함하는 경우에만 적용됩니다. 여기서 와일드카드 문자는 "C:\Windows" 디렉터리의 내용을 지정합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Filter
공급자의 형식 또는 언어로 필터를 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다.
와일드카드 문자 사용을 포함하여 필터의 구문은 공급자에 따라 달라집니다. 필터는 검색된 후 PowerShell이 개체를 필터링하지 않고 cmdlet이 개체를 가져올 때 공급자가 적용하기 때문에 다른 매개 변수보다 더 효율적입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Force
이 cmdlet은 숨겨진 항목과 같이 액세스할 수 없는 항목을 가져옵니다. 구현은 공급자마다 다릅니다. 자세한 내용은 about_Providers참조하세요. Force 매개 변수를 사용하더라도 cmdlet은 보안 제한을 재정의할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Include
문자열 배열로 이 cmdlet이 작업에 포함하는 항목 또는 항목을 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: "*.txt")을 입력합니다. 와일드카드 문자가 허용됩니다.
Include 매개 변수는 명령이 "C:\Windows*"와 같은 항목의 내용을 포함하는 경우에만 유효합니다. 여기서 와일드카드 문자는 "C:\Windows" 디렉터리의 내용을 지정합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-LiteralPath
항목의 경로를 지정합니다. Path 매개 변수와 달리 LiteralPath 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.
형식: | String[] |
별칭: | PSPath |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Path
항목의 경로를 지정합니다. 이 cmdlet은 지정된 위치에 있는 항목을 가져옵니다. 와일드카드가 허용됩니다. 이 매개 변수는 필수이지만 매개 변수 이름("Path")은 선택 사항입니다.
점('.')을 사용하여 현재 위치를 지정합니다. 와일드카드 문자('*')를 사용하여 현재 위치에 있는 모든 항목을 지정합니다.
형식: | String[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Stream
파일에서 지정된 대체 NTFS 파일 스트림을 가져옵니다. 스트림 이름을 입력합니다. 와일드카드가 지원됩니다. 모든 스트림을 얻으려면 별표(*)를 사용합니다. 이 매개 변수는 폴더에서 유효하지 않습니다.
Stream은 FileSystem 공급자가 Get-Item
cmdlet에 추가하는 동적 매개 변수입니다. 이 매개 변수는 파일 시스템 드라이브에서만 작동합니다.
형식: | String[] |
Position: | Named |
Default value: | No alternate file streams |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-UseTransaction
활성 트랜잭션에 명령을 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions참조하세요.
형식: | SwitchParameter |
별칭: | usetx |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
이 cmdlet에 대한 경로가 포함된 문자열을 파이프할 수 있습니다.
출력
이 cmdlet은 가져오는 개체를 반환합니다. 형식은 경로에 있는 개체의 형식에 따라 결정됩니다.
참고
이 cmdlet에는 Recurse 매개 변수가 없습니다. 해당 내용이 아닌 항목만 가져오기 때문입니다.
항목의 내용을 재귀적으로 얻으려면 Get-ChildItem
사용합니다.
레지스트리를 탐색하려면 이 cmdlet을 사용하여 레지스트리 키와 Get-ItemProperty
가져와 레지스트리 값과 데이터를 가져옵니다.
레지스트리 값은 레지스트리 키의 속성으로 간주됩니다.
이 cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다.
세션에서 사용할 수 있는 공급자를 나열하려면 Get-PsProvider
입력합니다.
자세한 내용은 about_Providers참조하세요.