하나 이상의 지정된 위치에서 항목 및 하위 항목을 가져옵니다.
구문
Get-ChildItem [[-Path] <string[]>] [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>] Get-ChildItem [-LiteralPath] <string[]> [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
설명
Get-ChildItem cmdlet은 하나 이상의 지정된 위치에서 항목을 가져옵니다. 항목이 컨테이너인 경우 컨테이너 내에 있는 항목(하위 항목이라고 함)을 가져옵니다. Recurse 매개 변수를 사용하여 모든 하위 컨테이너의 항목을 가져올 수 있습니다.
위치는 파일 시스템 위치(예: 디렉터리) 또는 다른 공급자에서 제공하는 위치(예: 레지스트리 하이브 또는 인증서 저장소)일 수 있습니다.
매개 변수
-Exclude <string[]>
지정된 항목을 생략합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: "*.txt")을 입력하십시오. 와일드카드를 사용할 수 있습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Filter <string>
공급자의 형식 또는 언어에 필터를 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 와일드카드 사용을 포함하여 필터의 구문은 공급자에 따라 다릅니다. 공급자는 개체를 검색한 후에 Windows PowerShell을 통해 해당 개체를 필터링하는 대신 개체를 검색할 때 필터를 적용하기 때문에 필터는 다른 매개 변수보다 훨씬 효율적입니다.
|
필수 여부 |
false |
|
위치 |
2 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Force
cmdlet이 숨겨진 파일이나 시스템 파일 등 다른 방법으로는 사용자가 액세스할 수 없는 항목을 가져올 수 있도록 합니다. 구현은 공급자마다 다릅니다. 자세한 내용은 about_Providers를 참조하십시오. Force 매개 변수를 사용해도 cmdlet은 보안 제한을 재정의할 수 없습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Include <string[]>
지정된 항목만 검색합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: "*.txt")을 입력하십시오. 와일드카드를 사용할 수 있습니다.
Include 매개 변수는 Recurse 매개 변수가 명령에 포함되어 있거나 C:\Windows\*(여기서 와일드카드 문자는 C:\Windows 디렉터리의 내용을 지정함)와 같이 경로가 디렉터리의 내용으로 연결되는 경우에만 작동합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-LiteralPath <string[]>
하나 이상의 위치에 대한 경로를 지정합니다. Path와 달리 LiteralPath 값은 입력한 그대로 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 경로를 작은따옴표로 묶어야 합니다. 작은따옴표는 Windows PowerShell이 어떤 문자도 이스케이프 시퀀스로 해석하지 않도록 지시합니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Name
대상 위치에서 항목 이름만 검색합니다. 이 명령의 출력을 다른 명령으로 연결할 경우 항목 이름만 전송됩니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Path <string[]>
하나 이상의 위치에 대한 경로를 지정합니다. 와일드카드를 사용할 수 있습니다. 기본 위치는 현재 디렉터리(.)입니다.
|
필수 여부 |
false |
|
위치 |
1 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByValue, ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-Recurse
지정된 위치와 해당 위치의 모든 하위 항목에서 항목을 가져옵니다.
Recurse는 경로가 하위 항목이 있는 컨테이너(예: C:\Windows 또는 C:\Windows\*)를 가리키는 경우에만 작동하며, 하위 항목이 없는 컨테이너(예: C:\Windows\*.exe)를 가리키는 경우에는 작동하지 않습니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-UseTransaction
명령을 활성 트랜잭션에 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions를 참조하십시오.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.String 경로가 포함된 문자열을 Get-ChildItem으로 파이프할 수 있습니다. |
|
출력 |
개체 Get-ChildItem이 반환하는 개체의 유형은 개체가 사용되는 공급자에 따라 결정됩니다. |
참고
또한 해당 기본 제공 별칭("ls", "dir" 및 "gci")으로 Get-ChildItem을 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.
Get-ChildItem은 기본적으로 숨겨진 항목을 가져오지 않습니다. 숨겨진 항목을 가져오려면 -Force를 사용합니다.
Get-ChildItem cmdlet은 모든 공급자가 제공하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PsProvider"를 입력합니다. 자세한 내용은 about_Providers를 참조하십시오.
예 1
C:\PS>get-childitem 설명 ----------- 이 명령은 현재 위치의 하위 항목을 가져옵니다. 위치가 파일 시스템 디렉터리인 경우 현재 디렉터리의 파일 및 하위 디렉터리를 가져옵니다. 항목에 하위 항목이 없으면 아무 내용도 표시하지 않고 명령 프롬프트로 돌아갑니다. 기본 표시에는 모드(특성), 마지막 작성 시간, 파일 크기(길이) 및 파일 이름이 나열됩니다. 모드의 유효한 값은 d(디렉터리), a(보관), r(읽기 전용), h(숨김) 및 s(시스템)입니다.
예 2
C:\PS>get-childitem . -include *.txt -recurse -force 설명 ----------- 이 명령은 현재 디렉터리와 해당 하위 디렉터리에서 모든 .txt 파일을 검색합니다. 점(.)은 현재 디렉터리를 나타내고 Include 매개 변수는 파일 이름 확장명을 지정합니다. Recurse 매개 변수는 Windows PowerShell이 개체를 재귀적으로 검색하도록 지시하며, 명령의 대상이 지정된 디렉터리 및 해당 내용임을 나타냅니다. Force 매개 변수는 숨겨진 파일을 표시에 추가합니다.
예 3
C:\PS>get-childitem c:\windows\logs\* -include *.txt -exclude A* 설명 ----------- 이 명령은 이름이 A로 시작하는 .txt 파일을 제외하고 Logs 하위 디렉터리의 .txt 파일을 나열합니다. 이 명령은 와일드카드 문자(*)를 사용하여 디렉터리 컨테이너가 아니라 Logs 하위 디렉터리의 내용을 나타냅니다. Recurse 매개 변수가 없으므로 Get-ChildItem은 디렉터리 내용을 자동으로 포함하지 않습니다. 따라서 별도로 지정해야 합니다.
예 4
C:\PS>get-childitem registry::hklm\software 설명 ----------- 이 명령은 로컬 컴퓨터 레지스트리의 HKEY_LOCAL_MACHINE\SOFTWARE 키에서 모든 레지스트리 키를 검색합니다.
예 5
C:\PS>get-childitem -name 설명 ----------- 이 명령은 현재 디렉터리에서 항목 이름만 검색합니다.
예 6
C:\PS>get-childitem cert:\. -recurse -codesigningcert 설명 ----------- 이 명령은 인증서 저장소에서 코드 서명 기관이 있는 모든 인증서를 가져옵니다. 이 명령은 Get-ChildItem cmdlet을 사용합니다. 경로는 Windows PowerShell 인증서 공급자에서 제공하는 Cert: 드라이브를 지정합니다. 백슬래시(\) 기호는 인증서 저장소의 하위 디렉터리를 지정하고, 점(.)은 현재 디렉터리(인증서 저장소의 루트 디렉터리)를 나타냅니다. Recurse 매개 변수는 재귀적 검색을 지정합니다. CodeSigningCertificate 매개 변수는 코드 서명 기관이 있는 인증서만 가져오는 동적 매개 변수입니다. 자세한 내용을 보려면 "get-help certificate"를 입력하십시오.
예 7
C:\PS>get-childitem * -include *.exe 설명 ----------- 이 명령은 현재 디렉터리에서 파일 이름 확장명이 ".exe"인 모든 항목을 검색합니다. 와일드카드 문자(*)는 현재 디렉터리(컨테이너가 아님)의 내용을 나타냅니다. Recurse 매개 변수 없이 Include 매개 변수를 사용할 경우 경로는 컨테이너가 아니라 내용을 가리켜야 합니다.
참고 항목