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>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]
Description
cmdlet은 Get-Item
지정된 위치에 있는 항목을 가져옵니다. 와일드카드 문자(*
)를 사용하여 항목의 모든 내용을 요청하지 않는 한 해당 위치에서 항목의 내용을 가져올 수 없습니다.
이 cmdlet은 PowerShell 공급자가 다양한 유형의 데이터 저장소를 탐색하는 데 사용됩니다. 일부 매개 변수는 특정 공급자에 대해서만 사용할 수 있습니다. 자세한 내용은 about_Providers 참조하세요.
예제
예제 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:
가져옵니다. 와일드카드 문자(*
)는 컨테이너뿐만 아니라 컨테이너의 모든 항목을 나타냅니다.
Get-Item C:\*
PowerShell에서 기존 *.*
별표 대신 단일 별표(*
)를 사용하여 콘텐츠를 가져옵니다. 형식은 리터럴로 해석되므로 *.*
점이 없는 디렉터리 또는 파일 이름을 검색하지 않습니다.
예제 5: 지정된 디렉터리에서 속성 가져오기
이 예제에서는 디렉터리의 LastAccessTime 속성을 C:\Windows
가져옵니다. LastAccessTime 은 파일 시스템 디렉터리 중 하나의 속성일 뿐입니다. 디렉터리의 모든 속성을 보려면 .를 입력합니다 (Get-Item <directory-name>) | Get-Member
.
(Get-Item C:\Windows).LastAccessTime
예제 6: 레지스트리 키의 내용 표시
이 예제에서는 Microsoft.PowerShell 레지스트리 키의 내용을 보여 줍니다. PowerShell 레지스트리 공급자와 함께 이 cmdlet을 사용하여 레지스트리 키와 하위 키를 가져올 수 있지만, cmdlet을 사용하여 Get-ItemProperty
레지스트리 값과 데이터를 가져와야 합니다.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
예제 7: 제외가 있는 디렉터리의 항목 가져오기
이 예제에서는 점(.
)을 포함하지만 시작 w*
하지 않는 이름을 가진 Windows 디렉터리의 항목을 가져옵니다. 이 예제는 경로에 와일드카드 문자(*
)가 포함되어 항목의 내용을 지정하는 경우에만 작동합니다.
Get-Item C:\Windows\*.* -Exclude "w*"
매개 변수
-CodeSigningCert
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
EnhancedKeyUsageList 속성 값에 있는 Code Signing
인증서를 얻으려면 CodeSigningCert 매개 변수를 사용합니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Credential
참고 항목
이 매개 변수는 PowerShell과 함께 설치된 공급자에서 지원되지 않습니다. 다른 사용자를 가장하거나 이 cmdlet을 실행할 때 자격 증명을 높이려면 Invoke-Command를 사용합니다.
형식: | PSCredential |
Position: | Named |
Default value: | Current user |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-DnsName
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
cmdlet이 가져오는 인증서의 DNSNameList 속성과 일치하는 도메인 이름 또는 이름 패턴을 지정합니다. 이 매개 변수의 값은 다음과 같습니다 Unicode
ASCII
. Punycode 값은 유니코드로 변환됩니다. 와일드카드 문자(*
)가 허용됩니다.
이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | DnsNameRepresentation |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-DocumentEncryptionCert
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
EnhancedKeyUsageList 속성 값에 있는 Document Encryption
인증서를 얻으려면 DocumentEncryptionCert 매개 변수를 사용합니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Eku
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
cmdlet이 가져오는 인증서의 EnhancedKeyUsageList 속성과 일치하도록 텍스트 또는 텍스트 패턴을 지정합니다. 와일드카드 문자(*
)가 허용됩니다. EnhancedKeyUsageList 속성에는 EKU의 이름 및 OID 필드가 포함됩니다.
이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Exclude
문자열 배열로 이 cmdlet이 작업에서 제외하는 항목 또는 항목을 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: *.txt
.)을 입력합니다. 와일드카드 문자를 사용할 수 있습니다. Exclude 매개 변수는 와일드카드 문자가 디렉터리의 내용을 지정하는 항목의 내용(예: C:\Windows\*
명령)이 포함된 경우에만 유효합니다C:\Windows
.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-ExpiringInDays
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
cmdlet은 지정된 일 수 또는 그 이전에 만료되는 인증서만 반환해야 하며, 값 0(0
)은 만료된 인증서를 가져옵니다.
이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Filter
Path 매개 변수를 한정할 필터를 지정합니다. FileSystem 공급자는 필터를 지원하는 유일한 설치된 PowerShell 공급자입니다. 필터는 다른 매개 변수보다 더 효율적입니다. 공급자는 cmdlet이 검색된 후 PowerShell이 개체를 필터링하지 않고 개체를 가져올 때 필터를 적용합니다. 필터 문자열은 파일을 열거하기 위해 .NET API에 전달됩니다. API는 지원 및 ?
와일드카드만 지원 *
합니다.
형식: | 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
하나 이상의 위치에 대한 경로를 지정합니다. LiteralPath의 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.
자세한 내용은 about_Quoting_Rules 참조하세요.
형식: | String[] |
별칭: | PSPath |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Path
항목의 경로를 지정합니다. 이 cmdlet은 지정된 위치에 있는 항목을 가져옵니다. 와일드카드 문자를 사용할 수 있습니다. 이 매개 변수는 필수이지만 매개 변수 이름 경로 는 선택 사항입니다.
점(.
)을 사용하여 현재 위치를 지정합니다. 와일드카드 문자(*
)를 사용하여 현재 위치에 있는 모든 항목을 지정합니다.
형식: | String[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-SSLServerAuthentication
인증서 공급자가 사용할 수 있는 동적 매개 변수입니다.
EnhancedKeyUsageList 속성 값에 있는 Server Authentication
인증서를 얻으려면 SSLServerAuthentication 매개 변수를 사용합니다.
자세한 내용은 about_Certificate_Provider 참조하세요.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Stream
FileSystem 공급자가 사용할 수 있는 동적 매개 변수입니다.
파일에서 지정된 대체 NTFS 파일 스트림을 가져옵니다. 스트림 이름을 입력합니다. 와일드카드가 지원됩니다. 모든 스트림을 얻으려면 별표(*
)를 사용합니다. 이 매개 변수는 폴더에서 유효하지 않습니다.
이 매개 변수는 PowerShell 3.0에서 도입되었습니다.
자세한 내용은 about_FileSystem_Provider 참조하세요.
형식: | 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은 드라이브에 액세스할 때 이 형식을 출력합니다 Alias:
.
이 cmdlet은 드라이브에 액세스할 때 이러한 형식을 Cert:
출력합니다.
cmdlet은 드라이브에 액세스할 때 이 형식을 출력합니다 Env:
.
이 cmdlet은 파일 시스템 드라이브에 액세스할 때 이러한 형식을 출력합니다.
cmdlet은 드라이브에 액세스할 때 이러한 형식을 Function:
출력합니다.
이 cmdlet은 레지스트리 드라이브에 액세스할 때 이 형식을 출력합니다.
cmdlet은 드라이브에 액세스할 때 이 형식을 Variable:
출력합니다.
cmdlet은 드라이브에 액세스할 때 이러한 형식을 WSMan:
출력합니다.
참고
Windows PowerShell에는 다음 별칭이 포함됩니다.Get-Item
gi
이 cmdlet에는 Recurse 매개 변수가 없습니다. 이 매개 변수는 해당 내용이 아닌 항목만 가져오기 때문입니다.
항목의 콘텐츠를 재귀적으로 얻으려면 .를 사용합니다 Get-ChildItem
.
레지스트리를 탐색하려면 이 cmdlet을 사용하여 레지스트리 키를 가져와 레지스트리 값과 Get-ItemProperty
데이터를 가져옵니다. 레지스트리 값은 레지스트리 키의 속성으로 간주됩니다.
이 cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 .를 입력 Get-PsProvider
합니다. 자세한 내용은 about_Providers 참조하세요.
관련 링크
PowerShell