Get-ChildItem

참조

모듈:: Microsoft.PowerShell.Management

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

구문

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

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

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

Description

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

Get-ChildItem 는 빈 디렉터리를 표시하지 않습니다. Get-ChildItem 명령에 Depth 또는 Recurse 매개 변수가 포함된 경우 빈 디렉터리는 출력에 포함되지 않습니다.

위치는 PowerShell 공급자에 Get-ChildItem 의해 노출됩니다. 위치는 파일 시스템 디렉터리, 레지스트리 하이브 또는 인증서 저장소일 수 있습니다. 일부 매개 변수는 특정 공급자에 대해서만 사용할 수 있습니다. 자세한 내용은 about_Providers 참조하세요.

예제

예제 1: 파일 시스템 디렉터리에서 자식 항목 가져오기

이 예제에서는 파일 시스템 디렉터리에서 자식 항목을 가져옵니다. 파일 이름 및 하위 디렉터리 이름이 표시됩니다. 빈 위치의 경우 명령은 출력을 반환하지 않고 PowerShell 프롬프트로 돌아갑니다.

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 디렉터리를 지정합니다C:\Test. Get-ChildItem 는 PowerShell 콘솔에 파일 및 디렉터리를 표시합니다.

Get-ChildItem -Path C:\Test

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     08:29                Logs
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a----         2/1/2019     08:43            183 CreateTestFile.ps1
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

기본적으로 Get-ChildItem 모드(특성), LastWriteTime, 파일 크기(길이) 및 항목의 이름을 나열합니다. Mode 속성의 문자는 다음과 같이 해석될 수 있습니다.

l (링크)
d (디렉터리)
a (보관)
r (읽기 전용)
h (숨김)
s (시스템)

모드 플래그에 대한 자세한 내용은 about_Filesystem_Provider 참조하세요.

예제 2: 디렉터리에서 자식 항목 이름 가져오기

이 예제에서는 디렉터리에 있는 항목의 이름만 나열합니다.

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 디렉터리를 지정합니다C:\Test. Name 매개 변수는 지정된 경로에서 파일 또는 디렉터리 이름만 반환합니다. 반환되는 이름은 Path 매개 변수의 값을 기준으로 합니다.

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

예제 3: 현재 디렉터리 및 하위 디렉터리에서 자식 항목 가져오기

다음은 현재 디렉터리와 해당 하위 디렉터리에 있는 파일을 표시하는 .txt 예제입니다.

Get-ChildItem -Path .\*.txt -Recurse -Force

Directory: C:\Test\Logs\Adirectory

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile4.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile4.txt

    Directory: C:\Test\Logs\Backup

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 ATextFile.txt
-a----        2/12/2019     15:50             20 LogFile3.txt

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 .를 지정합니다C:\Test\*.txt. 경로 는 별표(*) 와일드카드를 사용하여 파일 이름 확장 .txt명으로 모든 파일을 지정합니다. Recurse 매개 변수는 디렉터리: 제목에 표시된 대로 경로 디렉터리와 해당 하위 디렉터리를 검색합니다. Force 매개 변수는 h 모드와 같은 hiddenfile.txt 숨겨진 파일을 표시합니다.

예제 4: Include 매개 변수를 사용하여 자식 항목 가져오기

이 예제 Get-ChildItem 에서는 Include 매개 변수를 사용하여 Path 매개 변수로 지정된 디렉터리에서 특정 항목을 찾습니다.

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt



Get-ChildItem -Path C:\Test\* -Include *.txt

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 디렉터리를 지정합니다C:\Test. Path 매개 변수에는 디렉터리의 내용을 지정하는 후행 별표(*) 와일드카드가 포함됩니다. Include 매개 변수는 별표(*) 와일드카드를 사용하여 파일 이름 확장.txt명을 가진 모든 파일을 지정합니다.

Include 매개 변수를 사용하는 경우 Path 매개 변수는 디렉터리의 내용을 지정하기 위해 후행 별표(*) 와일드카드가 필요합니다. 예들 들어 -Path C:\Test\*입니다.

Recurse 매개 변수가 명령에 추가되면 Path 매개 변수의 후행 별표(*)는 선택 사항입니다. Recurse 매개 변수는 Path 디렉터리와 해당 하위 디렉터리에서 항목을 가져옵니다. 예를 들어 -Path C:\Test\ -Recurse -Include *.txt
후행 별표(*)가 Path 매개 변수에 포함되지 않은 경우 명령은 출력을 반환하지 않고 PowerShell 프롬프트로 돌아갑니다. 예들 들어 -Path C:\Test\입니다.

예제 5: Exclude 매개 변수를 사용하여 자식 항목 가져오기

예제의 출력은 디렉터리의 내용을 보여 줍니다 C:\Test\Logs. 출력은 제외 및 재귀 매개 변수를 사용하는 다른 명령에 대한 참조입니다.

Get-ChildItem -Path C:\Test\Logs

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 디렉터리를 지정합니다C:\Test\Logs. Exclude 매개 변수는 별표(*) 와일드카드를 사용하여 출력으로 A 시작하거나 출력에서 제외되는 모든 파일 또는 a 디렉터리를 지정합니다.

Exclude 매개 변수를 사용하는 경우 Path 매개 변수의 후행 별표(*)는 선택 사항입니다. 예를 들어 -Path C:\Test\Logs 또는 -Path C:\Test\Logs\*입니다.

후행 별표(*)가 Path 매개 변수에 포함되지 않으면 Path 매개 변수의 내용이 표시됩니다. 예외는 Exclude 매개 변수의 값과 일치하는 파일 이름 또는 하위 디렉터리 이름입니다.
Path 매개 변수에 후행 별표(*)가 포함된 경우 명령은 Path 매개 변수의 하위 디렉터리로 재귀됩니다. 예외는 Exclude 매개 변수의 값과 일치하는 파일 이름 또는 하위 디렉터리 이름입니다.
Recurse 매개 변수가 명령에 추가되면 Path 매개 변수에 후행 별표(*)가 포함되는지 여부에 관계없이 재귀 출력이 동일합니다.

예제 6: 레지스트리 하이브에서 레지스트리 키 가져오기

이 예제에서는 .에서 HKEY_LOCAL_MACHINE\HARDWARE모든 레지스트리 키를 가져옵니다.

Get-ChildItem 에서는 Path 매개 변수를 사용하여 레지스트리 키를 HKLM:\HARDWARE지정합니다. Hive의 경로 및 최상위 레지스트리 키는 PowerShell 콘솔에 표시됩니다.

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

Get-ChildItem -Path HKLM:\HARDWARE

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name             Property
----             --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI

Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name                           Property
----                           --------
ACPI
RESOURCEMAP

첫 번째 명령은 레지스트리 키의 HKLM:\HARDWARE 내용을 보여 줍니다. Exclude 매개 변수는 .로 시작하는 D*하위 키를 반환하지 않도록 지시 Get-ChildItem 합니다. 현재 Exclude 매개 변수는 항목 속성이 아닌 하위 키에서만 작동합니다.

예제 7: 코드 서명 기관을 사용하여 모든 인증서 가져오기

이 예제에서는 코드 서명 권한이 있는 PowerShell Cert: 드라이브의 각 인증서를 가져옵니다.

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 드라이브에 인증서 공급자를 지정합니다Cert:. Recurse 매개 변수는 Path 및 해당 하위 디렉터리로 지정된 디렉터리를 검색합니다. CodeSigningCert 매개 변수는 코드 서명 권한이 있는 인증서만 가져옵니다.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

인증서 공급자 및 Cert: 드라이브에 대한 자세한 내용은 about_Certificate_Provider 참조하세요.

예제 8: Depth 매개 변수를 사용하여 항목 가져오기

다음은 디렉터리 및 해당 하위 디렉터리의 항목을 표시하는 예제입니다. Depth 매개 변수는 재귀에 포함할 하위 디렉터리 수준의 수를 결정합니다. 빈 디렉터리 출력에서 제외됩니다.

Get-ChildItem -Path C:\Parent -Depth 2

Directory: C:\Parent

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level1
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level2
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1\SubDir_Level2

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:22                SubDir_Level3
-a----        2/13/2019     08:55             26 file.txt

cmdlet은 Get-ChildItem Path 매개 변수를 사용하여 .를 지정합니다C:\Parent. Depth 매개 변수는 두 가지 재귀 수준을 지정합니다. Get-ChildItem는 Path 매개 변수로 지정된 디렉터리의 내용과 두 가지 수준의 하위 디렉터리를 표시합니다.

예제 9: 하드 링크 정보 가져오기

PowerShell 6.2에서는 하드 링크 정보를 가져오기 위해 대체 보기가 추가되었습니다.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

예제 10: Windows가 아닌 운영 체제에 대한 출력

Unix 시스템의 Get-ChildItem PowerShell 7.1에서 Unix와 유사한 출력을 제공합니다.

PS> Get-ChildItem /etc/r*

Directory: /etc

UnixMode   User Group    LastWriteTime Size Name
--------   ---- -----    ------------- ---- ----
drwxr-xr-x root wheel  9/30/2019 19:19  128 racoon
-rw-r--r-- root wheel  9/26/2019 18:20 1560 rc.common
-rw-r--r-- root wheel  7/31/2017 17:30 1560 rc.common~previous
-rw-r--r-- root wheel  9/27/2019 20:34 5264 rc.netboot
lrwxr-xr-x root wheel  11/8/2019 15:35   22 resolv.conf -> /private/var/run/resolv.conf
-rw-r--r-- root wheel 10/23/2019 17:41    0 rmtab
-rw-r--r-- root wheel 10/23/2019 17:41 1735 rpc
-rw-r--r-- root wheel  7/25/2017 18:37 1735 rpc~previous
-rw-r--r-- root wheel 10/23/2019 18:42  891 rtadvd.conf
-rw-r--r-- root wheel  8/24/2017 21:54  891 rtadvd.conf~previous

이제 출력의 일부인 새 속성은 다음과 같습니다.

UnixMode 는 Unix 시스템에 표시되는 파일 권한입니다.
사용자가 파일 소유자입니다.
그룹이 그룹 소유자입니다.
크기 는 Unix 시스템에 표시되는 파일 또는 디렉터리의 크기입니다.

참고 항목

이 기능은 PowerShell 7.1에서 실험적 기능에서 일반 지원으로 이동되었습니다.

예제 11: 접합점에 대한 링크 대상 가져오기

dir Windows 명령 셸의 명령은 파일 시스템 접합점의 대상 위치를 표시합니다. PowerShell에서 이 정보는 반환 Get-ChildItem 된 파일 시스템 개체의 LinkTarget 속성에서 사용할 수 있으며 기본 출력에 표시됩니다.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object name,LinkTarget

Name     LinkTarget
----     ----------
tmp      C:\Users\user1\AppData\Local\Temp

PS D:\> Get-ChildItem

    Directory: D:\

Mode          LastWriteTime    Length Name
----          -------------    ------ ----
l----   12/16/2021  9:29 AM           tmp -> C:\Users\user1\AppData\Local\Temp

예제 12: AppX 재분석 지점에 대한 링크 대상 가져오기

이 예제에서는 AppX 재 분석 지점에 대한 대상 정보를 가져옵니다. Microsoft Store 애플리케이션은 사용자의 AppData 디렉터리에 AppX 재조사 지점을 만듭니다.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

현재 Windows는 AppX 재조사 지점에 대한 대상 정보를 가져오는 방법을 제공하지 않습니다. 파일 시스템 개체의 LinkTarget 및 LinkType 속성은 비어 있습니다.

매개 변수

-Attributes

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

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

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

일반적으로 사용되는 특성이 있는 파일 및 폴더를 찾으려면 Attributes 매개 변수를 사용합니다. 또는 매개 변수 디렉터리, 파일, 숨김, ReadOnly 및 System입니다.

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

보관
Compressed
디바이스
디렉터리
암호화됨
숨겨짐
IntegrityStream
Normal
NoScrubData
NotContentIndexed
오프라인
읽기 전용
ReparsePoint
SparseFile
시스템
임시

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

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

! (NOT)
+ (AND)
, (OR)

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

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

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

형식:	FlagsExpression<T>[FileAttributes]
허용되는 값:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CodeSigningCert

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

EnhancedKeyUsageList 속성 값에 있는 Code Signing 인증서 목록을 얻으려면 CodeSigningCert 매개 변수를 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Depth

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

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

참고 항목

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

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Directory

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

형식:	SwitchParameter
별칭:	ad
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DnsName

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

cmdlet이 가져오는 인증서의 DNSNameList 속성과 일치하는 도메인 이름 또는 이름 패턴을 지정합니다. 이 매개 변수의 값은 다음과 같습니다 Unicode ASCII. Punycode 값은 유니코드로 변환됩니다. 와일드카드 문자(*)가 허용됩니다.

이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.

형식:	DnsNameRepresentation
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	True

-DocumentEncryptionCert

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

EnhancedKeyUsageList 속성 값에 있는 Document Encryption 인증서 목록을 얻으려면 DocumentEncryptionCert 매개 변수를 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Eku

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

cmdlet이 가져오는 인증서의 EnhancedKeyUsageList 속성과 일치하도록 텍스트 또는 텍스트 패턴을 지정합니다. 와일드카드 문자(*)가 허용됩니다. EnhancedKeyUsageList 속성에는 EKU의 이름 및 OID 필드가 포함됩니다.

이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	True

-Exclude

cmdlet이 자식 항목을 가져오면 일치시킬 하나 이상의 문자열 패턴 배열을 지정합니다. 일치하는 항목은 출력에서 제외됩니다. 경로 요소 또는 패턴(예: *.txt 또는 A*.)을 입력합니다. 와일드카드 문자가 허용됩니다.

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

Include 및 Exclude 매개 변수를 함께 사용할 수 있습니다. 그러나 제외는 포함 후 적용되며 최종 출력에 영향을 줄 수 있습니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	True

-ExpiringInDays

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

cmdlet은 지정된 일 수 또는 그 이전에 만료되는 인증서만 반환해야 하며, 값 0(0)은 만료된 인증서를 가져옵니다.

이 매개 변수는 PowerShell 7.1에서 다시 도입되었습니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-File

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

형식:	SwitchParameter
별칭:	af
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Filter

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

형식:	String
Position:	1
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	True

-FollowSymlink

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

기본적으로 cmdlet은 Get-ChildItem 재귀 중에 찾은 디렉터리에 대한 기호 링크를 표시하지만 재귀하지는 않습니다. FollowSymlink 매개 변수를 사용하여 해당 기호 링크를 대상으로 하는 디렉터리를 검색합니다. FollowSymlink는 동적 매개 변수이며 FileSystem 공급자에서만 지원됩니다.

이 매개 변수는 PowerShell 6.0에서 도입되었습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Force

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

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Hidden

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

형식:	SwitchParameter
별칭:	ah, h
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Include

cmdlet이 자식 항목을 가져오면 일치시킬 하나 이상의 문자열 패턴 배열을 지정합니다. 일치하는 항목이 출력에 포함됩니다. 경로 요소 또는 패턴(예: "*.txt".)을 입력합니다. 와일드카드 문자를 사용할 수 있습니다. Include 매개 변수는 명령에 와일드카드 문자가 디렉터리의 내용을 지정하는 항목의 내용(예: C:\Windows\*포함)을 C:\Windows 포함하는 경우에만 유효합니다.

Include 및 Exclude 매개 변수를 함께 사용할 수 있습니다. 그러나 제외는 포함 후 적용되며 최종 출력에 영향을 줄 수 있습니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	True

-LiteralPath

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

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

형식:	String[]
별칭:	PSPath, LP
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

위치에 있는 항목의 이름만 가져옵니다. 출력은 파이프라인을 다른 명령으로 보낼 수 있는 문자열 개체입니다. 반환되는 이름은 Path 매개 변수의 값을 기준으로 합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

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

형식:	String[]
Position:	0
Default value:	Current directory
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	True

-ReadOnly

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

형식:	SwitchParameter
별칭:	ar
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Recurse

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

형식:	SwitchParameter
별칭:	s
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SSLServerAuthentication

참고 항목

이 매개 변수는 인증서 공급자에서만 사용할 수 있습니다.

EnhancedKeyUsageList 속성 값에 있는 Server Authentication 인증서 목록을 얻으려면 SSLServerAuthentication 매개 변수를 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-System

참고 항목

이 매개 변수는 FileSystem 공급자에서만 사용할 수 있습니다.

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

형식:	SwitchParameter
별칭:	as
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

이 cmdlet에 대한 경로가 포함된 문자열을 파이프할 수 있습니다.

출력

AliasInfo

cmdlet은 드라이브에 액세스할 때 이 형식을 출력합니다 Alias: .

X509StoreLocation

X509Store

X509Certificate2

이 cmdlet은 드라이브에 액세스할 때 이러한 형식을 Cert: 출력합니다.

DictionaryEntry

cmdlet은 드라이브에 액세스할 때 이 형식을 출력합니다 Env: .

DirectoryInfo

FileInfo

이 cmdlet은 파일 시스템 드라이브에 액세스할 때 이러한 형식을 출력합니다.

FunctionInfo

FilterInfo

cmdlet은 드라이브에 액세스할 때 이러한 형식을 Function: 출력합니다.

RegistryKey

이 cmdlet은 레지스트리 드라이브에 액세스할 때 이 형식을 출력합니다.

PSVariable

cmdlet은 드라이브에 액세스할 때 이 형식을 Variable: 출력합니다.

WSManConfigContainerElement

WSManConfigLeafElement

cmdlet은 드라이브에 액세스할 때 이러한 형식을 WSMan: 출력합니다.

String

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

참고

PowerShell에는 다음 별칭이 포함됩니다.Get-ChildItem

모든 플랫폼:
- dir, gci
Windows:
- ls

Get-ChildItem 는 기본적으로 숨겨진 항목을 가져오지 않습니다. 숨겨진 항목을 가져오려면 Force 매개 변수를 사용합니다.

cmdlet Get-ChildItem 은 모든 공급자가 노출하는 데이터와 함께 작동하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 .를 입력 Get-PSProvider합니다. 자세한 내용은 about_Providers 참조하세요.

다음을 통해 공유

Get-ChildItem

구문

Description

예제

예제 1: 파일 시스템 디렉터리에서 자식 항목 가져오기

예제 2: 디렉터리에서 자식 항목 이름 가져오기

예제 3: 현재 디렉터리 및 하위 디렉터리에서 자식 항목 가져오기

예제 4: Include 매개 변수를 사용하여 자식 항목 가져오기

예제 5: Exclude 매개 변수를 사용하여 자식 항목 가져오기

예제 6: 레지스트리 하이브에서 레지스트리 키 가져오기

예제 7: 코드 서명 기관을 사용하여 모든 인증서 가져오기

예제 8: Depth 매개 변수를 사용하여 항목 가져오기

예제 9: 하드 링크 정보 가져오기

예제 10: Windows가 아닌 운영 체제에 대한 출력

예제 11: 접합점에 대한 링크 대상 가져오기

예제 12: AppX 재분석 지점에 대한 링크 대상 가져오기

매개 변수

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

입력

출력

참고

관련 링크

추가 리소스