Get-ChildItem

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 получает элементы в одном или нескольких указанных местоположениях. Если элемент является контейнером, он получает элементы внутри контейнера, известные как дочерние элементы. Параметр Recurse можно использовать для получения элементов во всех дочерних контейнерах, а параметр Глубина — для ограничения количества уровней рекурсивного обхода.

Get-ChildItem не отображает пустые каталоги. Если команда Get-ChildItem включает параметры глубины или рекурсии , пустые каталоги не включаются в выходные данные.

Командлет Get-ChildItem предназначен для работы с элементами, предоставляемыми любым поставщиком. Например, элементы могут быть файлом файловой системы или каталогом, кустом реестра или хранилищем сертификатов. Чтобы вывести список поставщиков, доступных в сеансе, используйте команду Get-PSProvider. Некоторые параметры доступны только для конкретного поставщика. Дополнительные сведения см. в разделе о поставщиках.

Этот пример получает дочерние элементы из каталога файловой системы. Отображаются имена файлов и подкаталогов. Для пустых расположений команда не возвращает выходные данные и возвращается в строку PowerShell.

Командлет Get-ChildItem использует параметр пути , чтобы указать каталог C:\Test. В консоли PowerShell Get-ChildItem отображает файлы и каталоги.

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 перечисляет режим (атрибуты), время последнего изменения , размер файла (длина), а также имя элемента. Буквы в свойстве режима можно интерпретировать следующим образом:

• l (ссылка)
• d (каталог)
• a (архив)
• r (только для чтения)
• h (скрыто)
• s (система)

Дополнительные сведения о флагах режима см. в about_FileSystem_Provider.

В этом примере перечислены только имена элементов в каталоге.

Командлет Get-ChildItem использует параметр пути , чтобы указать каталог C:\Test. Параметр имени возвращает только имена файлов или каталогов из указанного пути. Возвращаемые имена относятся к значению параметра Path.

Get-ChildItem -Path C:\Test -Name

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

В этом примере отображаются .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

Командлет Get-ChildItem использует параметр пути для указания C:\Test\*.txt. Path использует подстановочный знак звездочки (*) для указания всех файлов с расширением имени файла .txt. Параметр Recurse выполняет поиск каталога Путь и его подкаталогов, как показано в заголовках Directory:. Параметр Force отображает скрытые файлы, такие как hiddenfile.txt, которые имеют режим ч.

В этом примере 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

Командлет Get-ChildItem использует параметр пути , чтобы указать каталог C:\Test. Параметр Path использует подстановочный знак в виде звёздочки (*), чтобы указать содержимое каталога. Параметр Include использует подстановочный знак звездочки (*) для указания всех файлов с расширением имени файла .txt.

Если используется параметр Include, параметр пути требует подстановочного знака "звёздочка" (*) для указания содержимого каталога. Например: -Path C:\Test\*.

• Если параметр Recurse добавляется в команду, то завершающая звездочка (*) в параметре Path является необязательной. Параметр Recurse получает элементы из каталога пути и его подкаталогов. Например: -Path C:\Test\ -Recurse -Include *.txt
• Если конечная звездочка (*) не включена в параметр Path, команда не возвращает выходные данные и возвращается в запрос PowerShell. Например: -Path C:\Test\.

Выходные данные примера показывают содержимое каталога 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

Командлет Get-ChildItem использует параметр пути , чтобы указать каталог C:\Test\Logs. Параметр Exclude использует подстановочный знак звездочки (*), чтобы указать, что все файлы или каталоги, начинающиеся с A или a, исключаются из выходных данных.

Если используется параметр Exclude, конечная звездочка (*) в параметре Path является необязательной. Например, -Path C:\Test\Logs или -Path C:\Test\Logs\*.

• Если в параметр * не включена конечная звездочка (), отображается содержимое параметра Путь. Исключения — это имена файлов или имена подкаталогов, соответствующие значению параметра Exclude.
• Если в параметр * включена следующая звездочка (), команда рекурсируется в подкаталоги параметра пути . Исключения — это имена файлов или имена подкаталогов, соответствующие значению параметра Exclude.
• Если параметр Recurse добавляется в команду, выходные данные рекурсии такие же, независимо от того, включает ли параметр Path завершающую звездочку (*).

Этот пример получает все ключи реестра из HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem использует параметр для пути с целью указания раздела реестра 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 указывает Get-ChildItem не возвращать какие-либо подразделы, начинающиеся с D*. В настоящее время параметр Exclude работает только в подразделах, а не в свойствах элементов.

В этом примере получается каждый сертификат на диске PowerShell Cert: с полномочиями на подпись кода.

Командлет Get-ChildItem использует параметр Path для указания поставщика сертификатов на диске Cert:. Параметр Recurse выполняет поиск в каталоге, указанном Path, и его подкаталогах. Параметр CodeSigningCert получает только те сертификаты, которые обладают полномочиями для подписания кода.

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

Дополнительные сведения о поставщике сертификатов и диске Cert: см. в about_Certificate_Provider.

В этом примере отображаются элементы в каталоге и его подкаталогах. Параметр глубины определяет количество уровней подкаталогов, которые необходимо включить в рекурсию. Пустые каталоги исключаются из выходных данных.

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

Командлет Get-ChildItem использует параметр пути для указания C:\Parent. Параметр глубины задает два уровня рекурсии. Get-ChildItem отображает содержимое каталога, указанного параметром пути и двумя уровнями подкаталогов.

В PowerShell 6.2 было добавлено альтернативное представление для получения сведений о жесткой ссылке.

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

В PowerShell 7.1 на системах Unix Get-ChildItem обеспечивает 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.

Команда dir в командной оболочке Windows показывает целевое расположение точки соединения файловой системы. В PowerShell эти сведения доступны из свойства LinkTarget объекта файловой системы, возвращаемого Get-ChildItem, и отображаются в выходных данных по умолчанию.

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

В этом примере показано, как получить целевую информацию для точки повторного анализа AppX. Приложения Microsoft Store создают точки повторного анализа AppX в каталоге AppData пользователя.

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 объекта файловой системы пусты.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать строку, содержащую путь к этому командлету.

Командлет выводит этот тип при доступе к диску Alias:.

Командлет выводит эти типы при доступе к диску Cert:.

Командлет выводит этот тип при доступе к диску Env:.

Командлет выводит эти типы при доступе к дискам FileSystem.

Командлет выводит эти типы при доступе к Function: дискам.

Командлет выводит этот тип при доступе к реестровым дискам.

Командлет выводит этот тип при доступе к дискам Variable:.

Командлет выводит эти типы при доступе к WSMan: дискам.

При использовании параметра Name этот командлет возвращает имена объектов в виде строк.

PowerShell включает следующие псевдонимы для Get-ChildItem:

• Все платформы:
  • dir, gci
• Виндоус:
  • ls

поведение рекурсии с параметром Path:

При использовании Get-ChildItem -Recurse с параметром пути командлет выполняет поиск последнего компонента пути независимо от того, является ли он шаблоном подстановочного знака или литеральным именем.

• Если последний компонент пути соответствует существующей непосредственной подкаталоге целевого каталога, командлет выполняет рекурсивное перечисление в соответствующем каталоге.
• Если последний компонент пути не соответствует существующей непосредственной подкаталоге целевого каталога, командлет рекурсивно выполняет поиск иерархии целевого каталога для элементов, соответствующих последнему компоненту пути.

При использовании Get-ChildItem -Recurse с параметрами пути и имени поведение изменяется. Команда ищет последний компонент пути среди непосредственных дочерних элементов целевого каталога.

• Если существует совпадение между непосредственными дочерними элементами, командлет выполняет рекурсивное перечисление для соответствующих элементов. Сопоставление с подстановочными знаками происходит только один раз на верхнем уровне целевого каталога. Результаты обрабатываются так, как если бы они были индивидуально переданы параметру LiteralPath.
• Если последний компонент пути не соответствует элементам верхнего уровня, возникает ошибка.

Следует избегать использования параметра пути с параметром Recurse. Для достижения наилучших результатов:

• Используйте LiteralPath, чтобы указать целевой каталог, чтобы избежать активации рекурсивного поиска для последнего компонента пути.
• Используйте фильтру или включить параметры, чтобы указать подстановочные знаки или литеральные шаблоны, которые следует искать на каждом уровне иерархии целевого каталога.