Get-ChildItem

모듈:: Microsoft.PowerShell.Management Module

하나 이상의 지정된 위치에서 항목과 자식 항목을 가져옵니다.

구문

Items (기본값)

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

LiteralItems

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

Description

Get-ChildItem cmdlet은 하나 이상의 지정된 위치에 있는 항목을 가져옵니다. 항목이 컨테이너인 경우 자식 항목이라고 하는 컨테이너 내의 항목을 가져옵니다. Recurse 매개 변수를 사용하여 모든 자식 컨테이너에서 항목을 가져오고 Depth 매개 변수를 사용하여 재귀할 수준 수를 제한할 수 있습니다.

Get-ChildItem 빈 디렉터리를 표시하지 않습니다. Get-ChildItem 명령에 Depth 또는 재귀 매개 변수가 포함되어 있으면 빈 디렉터리는 출력에 포함되지 않습니다.

위치는 PowerShell 공급자에 의해 Get-ChildItem에 노출됩니다. 위치는 파일 시스템 디렉터리, 레지스트리 하이브 또는 인증서 저장소일 수 있습니다. 추가 정보는 about_Providers를 참조하십시오.

매개 변수

-Attributes

지정된 특성이 있는 파일 및 폴더를 가져옵니다. 이 매개 변수는 모든 특성을 지원하며 특성의 복잡한 조합을 지정할 수 있습니다.

예를 들어 암호화되거나 압축된 비시스템 파일(디렉터리 아님)을 얻으려면 다음을 입력합니다.

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

일반적으로 사용되는 특성이 있는 파일 및 폴더를 찾으려면 Attributes 매개 변수를 사용합니다. 또는 매개 변수 디렉터리, 파일, 숨겨진, 읽기 전용및 시스템.

Attributes 매개 변수는 다음 속성을 지원합니다.

아카이브
압축된
디바이스
디렉터리
암호화됨
숨겨진
IntegrityStream
표준
데이터 스크럽 금지
콘텐츠_인덱싱_안됨
오프라인
ReadOnly
ReparsePoint
희소 파일 (SparseFile)
시스템
임시

이러한 특성에 대한 설명은 FileAttributes 열거형참조하세요.

특성을 결합하려면 다음 연산자를 사용합니다.

!(아님)
+(그리고)
,(OR)

연산자와 해당 특성 사이에 공백을 사용하지 마세요. 공백은 쉼표 뒤에 허용됩니다.

일반적인 특성의 경우 다음 약어를 사용합니다.

D (디렉터리)
H(숨김)
R(읽기 전용)
S(시스템)

매개 변수 속성

형식:	FlagsExpression<T>[FileAttributes]
Default value:	None
허용되는 값:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Depth

이 매개 변수는 PowerShell 5.0에 추가되었으며 재귀 깊이를 제어할 수 있습니다. 기본적으로 Get-ChildItem 부모 디렉터리의 내용을 표시합니다. Depth 매개 변수는 재귀에 포함된 하위 디렉터리 수준의 수를 결정하고 내용을 표시합니다.

예를 들어 Depth 2에는 경로 매개 변수의 디렉터리, 그리고 첫 번째 및 두 번째 수준의 하위 디렉터리가 포함됩니다. 기본적으로 디렉터리 이름과 파일 이름은 출력에 포함됩니다.

비고

PowerShell 또는 cmd.exeWindows 컴퓨터에서 tree.com 명령을 사용하여 디렉터리 구조의 그래픽 보기를 표시할 수 있습니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Directory

디렉터리 목록을 얻으려면 Directory 속성과 함께 Directory 매개 변수 또는 Attributes 매개 변수를 사용합니다. Recurse 매개 변수를 Directory에서 사용할 수 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	광고, d

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Exclude

이 cmdlet이 작업에서 제외하는 속성 또는 속성을 문자열 배열로 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: *.txt 또는 A*)을 입력합니다. 와일드카드 문자가 허용됩니다.

* 매개 변수의 후행 별표()는 선택 사항입니다. 예를 들어 -Path C:\Test\Logs 또는 -Path C:\Test\Logs\*. 후행 별표(*)가 포함된 경우 명령은 Path 매개 변수의 하위 디렉터리로 재귀됩니다. 별표(*)가 없으면 Path 매개 변수의 내용이 표시됩니다. 자세한 내용은 예제 5 및 메모 섹션에 포함되어 있습니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-File

파일 목록을 얻으려면 File 매개 변수를 사용합니다. Recurse 매개 변수를 File과 함께 사용할 수 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	아프리카

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Filter

Path 매개 변수를 한정할 필터를 지정합니다. FileSystem 공급자는 필터 사용을 지원하는 유일한 설치된 PowerShell 공급자입니다. 필터는 cmdlet이 개체를 검색할 때 공급자가 이를 적용하기 때문에 개체가 검색된 후에 PowerShell이 개체를 필터링하는 것보다 다른 매개 변수에 비해 더 효율적입니다. 필터 문자열은 파일을 열거하기 위해 .NET API에 전달됩니다. 해당 API는 * 및 ? 와일드카드만 지원합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Force

cmdlet이 숨겨진 파일이나 시스템 파일과 같이 사용자가 액세스할 수 없는 항목을 가져올 수 있도록 허용합니다. Force 매개 변수는 보안 제한을 재정의하지 않습니다. 구현은 공급자마다 다릅니다. 추가 정보는 about_Providers를 참조하십시오.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Hidden

숨겨진 항목만 가져오려면 Hidden 속성과 함께 Hidden 매개 변수 또는 Attributes 매개 변수를 사용합니다. 기본적으로 Get-ChildItem 숨겨진 항목을 표시하지 않습니다. Force 매개 변수를 사용하여 숨겨진 항목을 가져옵니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	아, h

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Include

문자열 배열로 이 cmdlet이 작업에 포함하는 항목 또는 항목을 지정합니다. 이 매개 변수의 값은 Path 매개 변수를 한정합니다. 경로 요소 또는 패턴(예: "*.txt")을 입력합니다. 와일드카드 문자가 허용됩니다. Include 매개 변수는 커맨드가 와일드카드 문자를 사용하여 C:\Windows\* 디렉터리의 내용을 지정하는 C:\Windows와 같은 항목의 내용을 포함할 때에만 유효합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-LiteralPath

하나 이상의 위치에 대한 경로를 지정합니다. LiteralPath 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

자세한 내용은 about_Quoting_Rules참조하세요.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	PSPath

매개 변수 집합

LiteralItems

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-Name

위치에 있는 항목의 이름만 가져옵니다. 출력은 다른 명령으로 전달할 수 있는 문자열 객체입니다. 와일드카드가 허용됩니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Path

하나 이상의 위치에 대한 경로를 지정합니다. 와일드카드가 허용됩니다. 기본 위치는 현재 디렉터리(.)입니다.

매개 변수 속성

형식:	String[]
Default value:	Current directory
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

Items

Position:	0
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ReadOnly

읽기 전용 항목만 가져오려면 ReadOnly 매개 변수 또는 Attributes 매개 변수 ReadOnly 속성을 사용합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	아칸소

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Recurse

지정된 위치 및 위치의 모든 자식 항목에 있는 항목을 가져옵니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	s

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-System

시스템 파일 및 디렉터리만 가져옵니다. 시스템 파일 및 폴더만 얻으려면 System 매개 변수 또는 Attributes 매개 변수 System 속성을 사용합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	처럼

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UseTransaction

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	usetx

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

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

출력

Object

Get-ChildItem 반환하는 개체의 형식은 공급자 드라이브 경로의 개체에 의해 결정됩니다.

String

Name 매개 변수를 사용하는 경우 Get-ChildItem 개체 이름을 문자열로 반환합니다.

참고

기본 제공 별칭, Get-ChildItem, ls및 dirgci 참조할 수 있습니다. 자세한 내용은 about_Aliases참조하세요.
Get-ChildItem 기본적으로 숨겨진 항목을 가져오지 않습니다. 숨겨진 항목을 가져오려면 Force 매개 변수를 사용합니다.
Get-ChildItem cmdlet은 모든 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PSProvider입력합니다. 추가 정보는 about_Providers를 참조하십시오.

다음을 통해 공유

Get-ChildItem

구문

Items (기본값)

LiteralItems

Description

매개 변수

-Attributes

매개 변수 속성

매개 변수 집합

-Depth

매개 변수 속성

매개 변수 집합

-Directory

매개 변수 속성

매개 변수 집합

-Exclude

매개 변수 속성

매개 변수 집합

-File

매개 변수 속성

매개 변수 집합

-Filter

매개 변수 속성

매개 변수 집합

-Force

매개 변수 속성

매개 변수 집합

-Hidden

매개 변수 속성

매개 변수 집합

-Include

매개 변수 속성

매개 변수 집합

-LiteralPath

매개 변수 속성

매개 변수 집합

-Name

매개 변수 속성

매개 변수 집합

-Path

매개 변수 속성

매개 변수 집합

-ReadOnly

매개 변수 속성

매개 변수 집합

-Recurse

매개 변수 속성

매개 변수 집합

-System

매개 변수 속성

매개 변수 집합

-UseTransaction

매개 변수 속성

매개 변수 집합

CommonParameters

입력

String

출력

Object

String

참고

관련 링크