Get-ChildItem for FileSystem

Назначение: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

Извлекает файлы и папки с диска файловой системы.

Синтаксис

Get-ChildItem [-Attributes <FileAttributes]>] [-Directory] [-File] [-Force] [-Hidden] [-ReadOnly] [-System] [-UseTransaction] [<CommonParameters>]

Описание

Командлет Get-ChildItem извлекает каталоги, подкаталоги и файлы с диска файловой системы. Командлет извлекает подкаталоги и файлы с диска файловой системы.

По умолчанию командлет Get-ChildItem извлекает нескрытые элементы, но можно использовать параметры Directory, File, Hidden, ReadOnly и System для извлечения только тех параметров, которые имеют эти атрибуты. Чтобы выполнить поиск по нескольким атрибутам, используйте параметр Attributes. При использовании этих параметров командлет Get-ChildItem извлекает только те элементы, которые соответствуют всем условиям поиска, так, как если бы эти параметры были соединены оператором AND.

Примечание. В этом файле справки по настраиваемому командлету объясняется, каким образом командлет Get-ChildItem работает с диском файловой системы. Чтобы получить сведения об использовании командлета Get-ChildItem для всех дисков, введите "Get-HelpGet-ChildItem -Path $null" или ознакомьтесь с разделом Get-ChildItem по адресу https://go.microsoft.com/fwlink/?LinkID=113308.

Параметры

-Attributes <FileAttributes]>

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

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

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

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

Параметр Attributes поддерживает следующие атрибуты: Archive, Compressed, Device, Directory, Encrypted, Hidden, Normal, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System и Temporary. Описание этих атрибутов см. в списке FileAttributes по адресу https://go.microsoft.com/fwlink/?LinkId=201508.

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

! NOT

+ AND

, OR

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

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

D Directory

H Hidden

R Read-only

S System

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-Directory

Извлекает каталоги (папки).

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

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

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Нет

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-File

Извлекает файлы.

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

Чтобы извлечь файлы, используйте параметр Directory, его псевдоним af или значение File для параметра Attributes.

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-Hidden

Возвращает только скрытые файлы или каталоги (папки). По умолчанию, Get-ChildItem возвращает только нескрытые элементы, но можно использовать параметр Force, чтобы включить скрытые элементы в результаты.

Чтобы извлечь только скрытые элементы, используйте параметр Hidden, его псевдонимы h или ah или значение Hidden параметра Attributes. Чтобы исключить скрытые элементы, опустите параметр Hidden или используйте параметр Attributes.

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-ReadOnly

Извлекает только файлы или каталоги (папки), доступные для чтения.

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

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-System

Извлекает только системные файлы или каталоги (папки).

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

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-Force

Возвращает скрытые файлы и папки. По умолчанию скрытые файлы и папки исключаются. Также скрытые файлы и папки можно извлечь с использованием параметра Hidden или значения Hidden параметра Attributes.

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-UseTransaction

Включает команду в активную транзакцию. Этот параметр доступен только при выполнении транзакции. Дополнительные сведения см. в разделе about_Transactions.

Требуется?

false

Указать положение?

с именем

Значение по умолчанию

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

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

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

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

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

System.String[]

Путь файловой системы (в кавычках) можно передать командлету Get-ChildItem по конвейеру.

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

System.IO.DirectoryInfo, System.IO.FileInfo, System.String

Примечания

Параметры Attributes, Directory, File, Hidden, ReadOnly и System были введены в Windows PowerShell 3.0 и

действуют только для дисков файловой системы.

Список псевдонимов командлета Get-ChildItem:

---------------------------------

Get-ChildItem dir

Directory d, ad

File af

Hidden h, ah

ReadOnly ar

System as

Пример 1

C:\PS>Get-ChildItem

Description
-----------
This command gets the files and subdirectories in the current directory. If the current directory does not have child items, the command does not return any results.





Пример 2

C:\PS>Get-Childitem -System -File -Recurse

Description
-----------
This command gets system files in the current directory and its subdirectories.





Пример 3

C:\PS>Get-ChildItem -Attributes !Directory,!Directory+Hidden

C:\PS> dir -att !d,!d+h

Description
-----------
These command get all files, including hidden files, in the current directory, but exclude subdirectories. The second command uses aliases and abbreviations, but has the same effect as the first.





Пример 4

C:\PS>dir -ad

Description
-----------
This command gets the subdirectories in the current directory. It uses the "dir" alias of the Get-ChildItem cmdlet and the "ad" alias of the Directory parameter.





Пример 5

C:\PS>Get-ChildItem -File -Attributes !ReadOnly -path C:\ps-test

Description
-----------
This command gets read-write files in the C:\ps-test directory.





Пример 6

C:\PS>get-childitem . -include *.txt -recurse -force

Description
-----------
This command gets all of the .txt files in the current directory and its subdirectories. 

The dot (.) represents the current directory. The Include parameter specifies the file name extension. The Recurse parameter directs Windows PowerShell to search for objects recursively, and it indicates that the subject of the command is the specified directory and its contents. The Force parameter adds hidden files to the display.





Пример 7

C:\PS>get-childitem c:\windows\logs\* -include *.txt -exclude A*

Description
-----------
This command gets the .txt files in the Logs subdirectory, except for those whose names start with the letter A. It uses the wildcard character (*) to indicate the contents of the Logs subdirectory, not the directory container. Because the command does not include the Recurse parameter, Get-ChildItem does not include the contents of the current directory automatically; you need to specify it.





Пример 8

C:\PS>get-childitem -name

Description
-----------
This command retrieves only the names of items in the current directory.





See Also

Concepts

Поставщик FileSystem

Other Resources

Clear-Content
Get-Content
Get-ChildItem
Get-Content
Get-Item
Remove-Item
Set-Content
Test-Path