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

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

Расположения предоставляются 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 C:\Test\*.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. Путь использует звездочку (*) wild карта для указания всех файлов с расширением имени .txtфайла. Параметр Recurse выполняет поиск каталога Path в его подкаталогах, как показано в каталоге : заголовки. Параметр 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 использует звездочку (*) wild карта для указания всех файлов с расширением .txtимени файла.

Если используется параметр Include, для указания содержимого каталога требуется следящий звездочку () дикий карта*. Например, -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

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

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

Примечание.

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

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

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

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

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

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

  • Архив
  • Compressed
  • Устройство
  • Каталог
  • Зашифрована
  • Скрыта
  • IntegrityStream
  • Нормальный
  • NoScrubData
  • NotContentIndexed
  • Автономный режим
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • Системные
  • Временные процедуры

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

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

  • ! (НЕ)
  • + (AND)
  • , (OR)

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

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

  • D (каталог)
  • H (Скрыто)
  • R (только для чтения)
  • S (Система)
Type:FlagsExpression<T>[FileAttributes]
Accepted values:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CodeSigningCert

Примечание.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Depth

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

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

Примечание.

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Примечание.

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

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

Type:SwitchParameter
Aliases:ad
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsName

Примечание.

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

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

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

Type:DnsNameRepresentation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-DocumentEncryptionCert

Примечание.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Eku

Примечание.

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

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

Конечный звездочку (*) в параметре Path является необязательным. Например, -Path C:\Test\Logs или -Path C:\Test\Logs\*. Если включено значение звездочки (*), команда рекурсируется в подкаталогы параметра Path . Без звездочки (*), отображается содержимое параметра Path . Дополнительные сведения включены в пример 5 и раздел "Заметки".

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ExpiringInDays

Примечание.

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

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

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Примечание.

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

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

Type:SwitchParameter
Aliases:af
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Примечание.

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

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

Этот параметр появился в PowerShell 6.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Hidden

Примечание.

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

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

Type:SwitchParameter
Aliases:ah, h
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

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

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

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:Current directory
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ReadOnly

Примечание.

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

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

Type:SwitchParameter
Aliases:ar
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Recurse

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

Type:SwitchParameter
Aliases:s
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSLServerAuthentication

Примечание.

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

Чтобы получить список сертификатов, имеющихся Server Authentication в значении свойства EnhancedKeyUsageList , используйте параметр SSLServerAuthentication .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-System

Примечание.

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

Возвращает только системные файлы и каталоги. Чтобы получить только системные файлы и папки, используйтесвойство System parameter или Attributes.

Type:SwitchParameter
Aliases:as
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

String

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

Выходные данные

AliasInfo

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

X509StoreLocation

X509Store

X509Certificate2

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

DictionaryEntry

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

DirectoryInfo

FileInfo

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

FunctionInfo

FilterInfo

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

RegistryKey

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

PSVariable

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

WSManConfigContainerElement

WSManConfigLeafElement

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

String

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

Примечания

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

  • Все платформы:
    • dir, gci
  • Windows:
    • ls

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

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