Get-ChildItem

구문

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>]

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: 접합점에 대한 링크 대상 가져오기

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

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

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

예제 10: 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

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

-UseTransaction

입력

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은 개체 이름을 문자열로 반환합니다.

참고

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

• ls
• dir
• gci

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

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

관련 링크

• about_Certificate_Provider
• about_Providers
• about_Quoting_Rules
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path