Get-ChildItem (Microsoft.PowerShell.Management)

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

Описание

Командлет Get-ChildItem получает элементы в одном или нескольких указанных местах. Если элемент является контейнером, он получает элементы внутри контейнера, называемые дочерними элементами. Вы можете использовать параметр Recurse, чтобы получить элементы во всех дочерних контейнерах, и использовать параметр Depth, чтобы ограничить количество рекурсивных уровней.

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

Местоположение предоставляется Get-ChildItem поставщиками PowerShell. Местоположением может быть каталог файловой системы, куст реестра или хранилище сертификатов. Некоторые параметры доступны только для конкретного провайдера. Дополнительные сведения см. в разделе about_Providers.

Примеры

Пример 1. Получение дочерних элементов из каталога файловой системы.

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

Командлет 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. Получение имен дочерних элементов в каталоге

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

Командлет 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

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

Пример 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

Командлет 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. Вывод является ссылкой для других команд, использующих параметры Exclude и Recurse.

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

Пример 7. Получите все сертификаты с полномочиями подписи кода.

В этом примере получаются все сертификаты на диске PowerShell Cert:, имеющие полномочия подписи кода.

Командлет 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

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

Пример 9: Получение информации о жестких ссылках

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

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

Пример 10. Вывод для операционных систем, отличных от Windows.

В 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.

Примечание

Эта функция была перенесена из экспериментальной в основную версию PowerShell 7.1.

Пример 11. Получение цели ссылки для точки соединения

Команда 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

Пример 12. Получение целевой ссылки для точки повторной обработки AppX

В этом примере делается попытка получить целевую информацию для точки повторной обработки 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 объекта файловой системы пусты.

Параметры

-Attributes

Примечание

Этот параметр доступен только в поставщике файловой системы.

Получает файлы и папки с указанными атрибутами. Этот параметр поддерживает все атрибуты и позволяет указывать сложные комбинации атрибутов.

Например, чтобы получить зашифрованные или сжатые несистемные файлы (не каталоги), введите:

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

Чтобы найти файлы и папки с часто используемыми атрибутами, используйте параметр Атрибуты. Или параметры Directory, File, Hidden, ReadOnly и System.

Параметр Атрибуты поддерживает следующие свойства:


Archive
Compressed
Device
Directory
Encrypted
Hidden
IntegrityStream
Normal
NoScrubData
NotContentIndexed
Offline
ReadOnly
ReparsePoint
SparseFile
System
Temporary

Описание этих атрибутов см. в перечислении FileAttributes.

Для объединения атрибутов используйте следующие операторы:

! (НЕ)
+ (И)
, (ИЛИ)

Не используйте пробелы между оператором и его атрибутом. Пробелы допускаются после запятых.

Для общих атрибутов используйте следующие сокращения:

D (Каталог)
H (Скрыт)
R (только чтение)
S (Система)

Тип :: FlagsExpression[FileAttributes]
Принятые значения:: Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-CodeSigningCert

Примечание

Этот параметр доступен только в поставщике сертификатов.

Чтобы получить список сертификатов, у которых есть Code Signing в значении свойства EnhancedKeyUsageList, используйте параметр CodeSigningCert.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Depth

Этот параметр был добавлен в PowerShell 5.0 и позволяет контролировать глубину рекурсии. По умолчанию Get-ChildItem отображает содержимое родительского каталога. Параметр Depth определяет количество уровней подкаталогов, которые включаются в рекурсию, и отображает их содержимое.

Например, -Depth 2 включает каталог параметра Path, первый уровень подкаталогов и второй уровень подкаталогов. По умолчанию имена каталогов и файлов включаются в выходные данные.

Примечание

На компьютере Windows с помощью PowerShell или cmd.exe вы можете отобразить графическое представление структуры каталогов с помощью команды tree.com.

Тип :: UInt32
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Directory

Примечание

Этот параметр доступен только в поставщике файловой системы.

Чтобы получить список каталогов, используйте параметр Directory или параметр Attributes со свойством Directory. Вы можете использовать параметр Recurse с Directory.

Тип :: SwitchParameter
Псевдонимы:: ad
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-DnsName

Примечание

Этот параметр доступен только в поставщике сертификатов.

Указывает имя домена или шаблон имени, соответствующий свойству DNSNameList сертификатов, получаемых командлетом. Значением этого параметра может быть либо Unicode, либо ASCII. Значения Punycode преобразуются в Unicode. Допускаются подстановочные знаки (*).

Этот параметр был вновь введен в PowerShell 7.1.

Тип :: Представление DNSName
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-DocumentEncryptionCert

Примечание

Этот параметр доступен только в поставщике сертификатов.

Чтобы получить список сертификатов, у которых есть Document Encryption в значении свойства EnhancedKeyUsageList, используйте параметр DocumentEncryptionCert.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Eku

Примечание

Этот параметр доступен только в поставщике сертификатов.

Указывает текст или текстовый шаблон, соответствующий свойству EnhancedKeyUsageList сертификатов, получаемых командлетом. Допускаются подстановочные знаки (*). Свойство EnhancedKeyUsageList содержит понятное имя и поля OID EKU.

Этот параметр был вновь введен в PowerShell 7.1.

Тип :: String
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-Exclude

Указывает массив из одного или нескольких шаблонов строк, которые будут сопоставляться при получении командлетом дочерних элементов. Любой соответствующий элемент исключается из вывода. Введите элемент пути или шаблон, например *.txt или A*. Допускаются символы подстановки.

Завершающая звездочка (*) в параметре Path не является обязательной. Например, -Path C:\Test\Logs или -Path C:\Test\Logs\*. Если в конце указана звездочка (*), команда возвращается в подкаталоги параметра Path. Без звездочки (*) отображается содержимое параметра Path. Более подробная информация включена в пример 5 и раздел «Примечания».

Параметры Include и Exclude можно использовать вместе. Однако исключения применяются после включений, что может повлиять на конечный результат.

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-ExpiringInDays

Примечание

Этот параметр доступен только в поставщике сертификатов.

Указывает, что командлет должен возвращать только сертификаты, срок действия которых истекает через указанное количество дней или раньше. Нулевое значение (0) позволяет получить сертификаты, срок действия которых истек.

Этот параметр был вновь введен в PowerShell 7.1.

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-File

Примечание

Этот параметр доступен только в поставщике файловой системы.

Чтобы получить список файлов, используйте параметр File. Вы можете использовать параметр Recurse с File.

Тип :: SwitchParameter
Псевдонимы:: af
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Filter

Указывает фильтр для уточнения параметра Path. Поставщик FileSystem — единственный установленный поставщик PowerShell, поддерживающий фильтры. Фильтры более эффективны, чем другие параметры. Поставщик применяет фильтр, когда командлет получает объекты, вместо того, чтобы PowerShell фильтровал объекты после их получения. Строка фильтра передается в API .NET для перечисления файлов. API поддерживает только подстановочные знаки * и ?.

Тип :: String
Позиция:: 1
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-FollowSymlink

Примечание

Этот параметр доступен только в поставщике файловой системы.

По умолчанию командлет Get-ChildItem отображает символические ссылки на каталоги, найденные во время рекурсии, но не выполняет рекурсивный вход в них. Используйте параметр FollowSymlink для поиска в каталогах, предназначенных для этих символических ссылок. FollowSymlink является динамическим параметром и поддерживается только в поставщике FileSystem.

Этот параметр был введен в PowerShell 6.0.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Force

Позволяет командлету получать элементы, к которым пользователь в противном случае не может получить доступ, например скрытые или системные файлы. Параметр Force не отменяет ограничения безопасности. Реализация варьируется в зависимости от поставщика. Дополнительные сведения см. в разделе about_Providers.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Hidden

Примечание

Этот параметр доступен только в поставщике файловой системы.

Чтобы получить только скрытые элементы, используйте параметр Hidden или параметр Attributes со свойством Hidden. По умолчанию Get-ChildItem не отображает скрытые элементы. Используйте параметр Force, чтобы получить скрытые элементы.

Тип :: SwitchParameter
Псевдонимы:: ah, h
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Include

Указывает массив из одного или нескольких шаблонов строк, которые будут сопоставляться при получении командлетом дочерних элементов. Любой соответствующий элемент включается в выходные данные. Введите элемент пути или шаблон, например "*.txt". Допускаются подстановочные знаки. Параметр Include действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое C:\Windows.

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-LiteralPath

Указывает путь к одному или нескольким местоположениям. Значение LiteralPath используется точно так, как оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки сообщают PowerShell не интерпретировать никакие символы как escape-последовательности.

Дополнительные сведения см. в разделе about_Quoting_Rules.

Тип :: String[]
Псевдонимы:: PSPath, LP
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Name

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

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Path

Указывает путь к одному или нескольким местоположениям. Подстановочные знаки принимаются. Местоположением по умолчанию является текущий каталог (.).

Тип :: String[]
Позиция:: 0
Значение по умолчанию:: Текущий каталог
Необходимый:: False
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: True

-ReadOnly

Примечание

Этот параметр доступен только в поставщике файловой системы.

Чтобы получить только элементы, доступные только для чтения, используйте параметр ReadOnly или свойство Attributes ReadOnly.

Тип :: SwitchParameter
Псевдонимы:: ar
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Recurse

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

Тип :: SwitchParameter
Псевдонимы:: s
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-SSLServerAuthentication

Примечание

Этот параметр доступен только в поставщике сертификатов.

Чтобы получить список сертификатов, которые имеют Аутентификацию сервера в значении свойства EnhancedKeyUsageList, используйте параметр SSLServerAuthentication.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-System

Примечание

Этот параметр доступен только в поставщике файловой системы.

Получает только системные файлы и каталоги. Чтобы получить только системные файлы и папки, используйте параметр Система или свойство Атрибуты параметра Система.

Тип :: SwitchParameter
Псевдонимы:: as
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

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

Выходы

Информация об псевдониме

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

X509StoreLocation

Магазин X509

X509Certificate2

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

DictionaryEntry

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

Информация о каталоге

Информация о файле

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

Информация о функции

Информация о фильтре

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

Ключ реестра

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

PSVariable

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

WSManConfigContainerElement

WSManConfigLeafElement

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

Строка

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

Примечания

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

Все платформы:
- каталог, gci
Windows:

Get-ChildItem по умолчанию не получает скрытые элементы. Чтобы получить скрытые элементы, используйте параметр Force.

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