Get-ChildItem

Odwołanie

Moduł:: Microsoft.PowerShell.Management

Pobiera elementy i elementy podrzędne w co najmniej jednej określonej lokalizacji.

Składnia

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint32>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint32>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Opis

Polecenie Get-ChildItem cmdlet pobiera elementy w co najmniej jednej określonej lokalizacji. Jeśli element jest kontenerem, pobiera elementy wewnątrz kontenera, znane jako elementy podrzędne. Możesz użyć parametru Recurse , aby pobrać elementy we wszystkich kontenerach podrzędnych i użyć parametru Głębokość , aby ograniczyć liczbę poziomów do ponownego wystąpienia.

Get-ChildItem nie wyświetla pustych katalogów. Gdy Get-ChildItem polecenie zawiera parametry Głębokość lub Recurse , puste katalogi nie są uwzględniane w danych wyjściowych.

Lokalizacje są udostępniane Get-ChildItem przez dostawców programu PowerShell. Lokalizacja może być katalogiem systemu plików, gałęzią rejestru lub magazynem certyfikatów. Aby uzyskać więcej informacji, zobacz about_Providers.

Przykłady

Przykład 1. Pobieranie elementów podrzędnych z katalogu systemu plików

Ten przykład pobiera elementy podrzędne z katalogu systemu plików. Zostaną wyświetlone nazwy plików i podkatalogów. W przypadku pustych lokalizacji polecenie nie zwraca żadnych danych wyjściowych i powraca do wiersza polecenia programu PowerShell.

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia katalogu C:\Test. Get-ChildItem wyświetla pliki i katalogi w konsoli programu 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

Domyślnie Get-ChildItem wyświetla tryb (atrybuty), LastWriteTime, rozmiar pliku (długość) i nazwę elementu. Litery we właściwości Mode można interpretować w następujący sposób:

l (link)
d (katalog)
a (archiwum)
r (tylko do odczytu)
h (ukryte)
s (system).

Aby uzyskać więcej informacji na temat flag trybu, zobacz about_Filesystem_Provider.

Przykład 2. Pobieranie nazw elementów podrzędnych w katalogu

W tym przykładzie wymieniono tylko nazwy elementów w katalogu.

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia katalogu C:\Test. Parametr Name zwraca tylko nazwy plików lub katalogów z określonej ścieżki.

Get-ChildItem -Path C:\Test -Name

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

Przykład 3. Pobieranie elementów podrzędnych w bieżącym katalogu i podkatalogach

W tym przykładzie są wyświetlane .txt pliki znajdujące się w bieżącym katalogu i jego podkatalogach.

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

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia C:\Test\*.txt. Ścieżka używa symbolu wieloznakowego gwiazdki (*), aby określić wszystkie pliki z rozszerzeniem .txtnazwy pliku . Parametr Recurse wyszukuje katalog Path jego podkatalogów, jak pokazano w nagłówkach Directory: . Parametr Force wyświetla ukryte pliki, takie jak hiddenfile.txt tryb h.

Przykład 4. Pobieranie elementów podrzędnych przy użyciu parametru Include

W tym przykładzie Get-ChildItem użyto parametru Include , aby znaleźć określone elementy z katalogu określonego przez parametr 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

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia katalogu C:\Test. Parametr Path zawiera końcową gwiazdkę (*) symbol wieloznaczny określający zawartość katalogu. Parametr Include używa symbolu wieloznakowego gwiazdki (*), aby określić wszystkie pliki z rozszerzeniem nazwy pliku .txt.

Gdy jest używany parametr Include , parametr Path wymaga końcowej gwiazdki (*) symbolu wieloznakowego w celu określenia zawartości katalogu. Na przykład -Path C:\Test\*.

Jeśli parametr Recurse zostanie dodany do polecenia, końcowa gwiazdka (*) w parametrze Ścieżka jest opcjonalna. Parametr Recurse pobiera elementy z katalogu Path i jego podkatalogów. Na przykład -Path C:\Test\ -Recurse -Include *.txt
Jeśli końcowa gwiazdka (*) nie jest uwzględniona w parametrze Path , polecenie nie zwraca żadnych danych wyjściowych i powraca do wiersza polecenia programu PowerShell. Na przykład -Path C:\Test\.

Przykład 5. Pobieranie elementów podrzędnych przy użyciu parametru Exclude

Dane wyjściowe przykładu pokazują zawartość katalogu C:\Test\Logs. Dane wyjściowe to odwołanie do innych poleceń, które używają parametrów Wykluczanie i rekurse .

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

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia katalogu C:\Test\Logs. Parametr Exclude używa symbolu wieloznakowego gwiazdki (*), aby określić wszystkie pliki lub katalogi rozpoczynające się od A lub a są wykluczone z danych wyjściowych.

Gdy jest używany parametr Exclude , znak gwiazdki (*) w parametrze Ścieżka jest opcjonalny. Na przykład: -Path C:\Test\Logs lub -Path C:\Test\Logs\*.

Jeśli końcowa gwiazdka (*) nie jest uwzględniona w parametrze Ścieżka , zostanie wyświetlona zawartość parametru Ścieżka . Wyjątki to nazwy plików lub podkatalogów, które pasują do wartości parametru Exclude .
Jeśli w parametrze Path znajduje się końcowa gwiazdka (*), polecenie jest powtarzane w podkatalogach parametru Path. Wyjątki to nazwy plików lub podkatalogów, które pasują do wartości parametru Exclude .
Jeśli parametr Recurse jest dodawany do polecenia, dane wyjściowe rekursji są takie same, czy parametr Path zawiera końcową gwiazdkę (*).

Przykład 6. Pobieranie kluczy rejestru z gałęzi rejestru

W tym przykładzie są pobierane wszystkie klucze rejestru z HKEY_LOCAL_MACHINE\HARDWAREprogramu .

Get-ChildItem używa parametru Ścieżka , aby określić klucz HKLM:\HARDWARErejestru . Ścieżka hive i najwyższy poziom kluczy rejestru są wyświetlane w konsoli programu PowerShell.

Aby uzyskać więcej informacji, zobacz 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

Pierwsze polecenie pokazuje zawartość HKLM:\HARDWARE klucza rejestru. Parametr Exclude informuje Get-ChildItem , aby nie zwracać żadnych podkluczów rozpoczynających się od D*. Obecnie parametr Exclude działa tylko w podkluczach, a nie we właściwościach elementu.

Przykład 7. Pobieranie wszystkich certyfikatów za pomocą urzędu podpisywania kodu

Ten przykład pobiera każdy certyfikat w certyfikacie programu PowerShell : dysk z urzędem podpisywania kodu.

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia dostawcy Cert: . Parametr Recurse wyszukuje katalog określony przez ścieżkę i jego podkatalogi. Parametr CodeSigningCert pobiera tylko certyfikaty, które mają urząd podpisywania kodu.

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

Aby uzyskać więcej informacji na temat dostawcy certyfikatów i dysku Cert:, zobacz about_Certificate_Provider.

Przykład 8. Pobieranie elementów przy użyciu parametru Głębokość

W tym przykładzie są wyświetlane elementy w katalogu i jego podkatalogach. Parametr Głębokość określa liczbę poziomów podkatalogu do uwzględnienia w rekursji. Puste katalogi są wykluczone z danych wyjściowych.

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

Polecenie Get-ChildItem cmdlet używa parametru Path do określenia C:\Parent. Parametr Głębokość określa dwa poziomy rekursji. Get-ChildItem wyświetla zawartość katalogu określonego przez parametr Path i dwa poziomy podkatalogów.

Przykład 9. Uzyskiwanie twardych informacji o linkach

W programie PowerShell 6.2 dodano widok alternatywny, aby uzyskać twarde informacje o linku.

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

Przykład 10: dane wyjściowe dla systemów operacyjnych innych niż Windows

W programie PowerShell 7.1 w systemach Get-ChildItem Unix zapewnia dane wyjściowe podobne do systemu 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

Nowe właściwości, które są teraz częścią danych wyjściowych, to:

UnixMode to uprawnienia do plików reprezentowane w systemie Unix
Użytkownik jest właścicielem pliku
Grupa jest właścicielem grupy
Rozmiar to rozmiar pliku lub katalogu reprezentowanego w systemie Unix

Uwaga

Ta funkcja została przeniesiona z eksperymentalnego do głównego nurtu w programie PowerShell 7.1.

Przykład 11 — pobieranie elementu docelowego łącza dla punktu skrzyżowania

Polecenie dir w powłoce poleceń systemu Windows pokazuje docelową lokalizację punktu skrzyżowania systemu plików. W programie PowerShell te informacje są dostępne we właściwości LinkTarget obiektu systemu plików zwróconego przez Get-ChildItem i są wyświetlane w domyślnych danych wyjściowych.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | select 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

Parametry

-Attributes

Pobiera pliki i foldery z określonymi atrybutami. Ten parametr obsługuje wszystkie atrybuty i umożliwia określenie złożonych kombinacji atrybutów.

Aby na przykład pobrać pliki niesystemowe (nie katalogi), które są zaszyfrowane lub skompresowane, wpisz:

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

Aby znaleźć pliki i foldery z często używanymi atrybutami, użyj parametru Atrybuty . Lub parametry Directory, File, Hidden, ReadOnly i System.

Parametr Attributes obsługuje następujące właściwości:

Archiwum
Skompresowane
Urządzenie
Directory
Zaszyfrowane
Ukryty
IntegrityStream
Normalne
NoScrubData
NotContentIndexed
Tryb offline
Readonly
ReparsePoint
Plik rozrzedny
System
Tymczasowe

Opis tych atrybutów można znaleźć w temacie FileAttributes Enumeration (Wyliczenie FileAttributes).

Aby połączyć atrybuty, użyj następujących operatorów:

! (NOT)
+ (AND)
, (LUB)

Nie używaj spacji między operatorem i jego atrybutem. Spacje są akceptowane po przecinkach.

W przypadku typowych atrybutów użyj następujących skrótów:

D (Katalog)
H (Ukryte)
R (Tylko do odczytu)
S (System)

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

-Depth

Ten parametr został dodany w programie PowerShell 5.0 i umożliwia kontrolowanie głębokości rekursji. Domyślnie Get-ChildItem wyświetla zawartość katalogu nadrzędnego. Parametr Głębokość określa liczbę poziomów podkatalogów, które są uwzględnione w rekursji i wyświetla zawartość.

Na przykład Depth 2 obejmuje katalog parametru Path , pierwszy poziom podkatalogów i drugi poziom podkatalogów. Domyślnie nazwy katalogów i nazwy plików są uwzględniane w danych wyjściowych.

Uwaga

Na komputerze z systemem Windows za pomocą programu PowerShell lub cmd.exemożna wyświetlić graficzny widok struktury katalogów za pomocą polecenia tree.com .

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

-Directory

Aby uzyskać listę katalogów, użyj parametru Directory lub parametru Attributes z właściwością Directory . Możesz użyć parametru Recurse z katalogiem.

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

-Exclude

Określa tablicę z co najmniej jednym wzorcem ciągów, które mają być dopasowane, ponieważ polecenie cmdlet pobiera elementy podrzędne. Każdy pasujący element jest wykluczony z danych wyjściowych. Wprowadź element ścieżki lub wzorzec, taki jak *.txt lub A*. Akceptowane są symbole wieloznaczne.

Końcowa gwiazdka (*) w parametrze Ścieżka jest opcjonalna. Na przykład: -Path C:\Test\Logs lub -Path C:\Test\Logs\*. Jeśli dołączana jest końcowa gwiazdka (*), polecenie jest powtarzane w podkatalogach parametru Path . Bez gwiazdki (*) wyświetlana jest zawartość parametru Path . Więcej szczegółów znajduje się w przykładzie 5 i sekcji Notatki.

Parametry Include i Exclude mogą być używane razem. Jednak wykluczenia są stosowane po włączeniu, które mogą mieć wpływ na końcowe dane wyjściowe.

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

-File

Aby uzyskać listę plików, użyj parametru Plik . Możesz użyć parametru Recurse z plikiem.

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

-Filter

Określa filtr, aby zakwalifikować parametr Ścieżka . Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell, który obsługuje filtry. Filtry są bardziej wydajne niż inne parametry. Dostawca stosuje filtr, gdy polecenie cmdlet pobiera obiekty, zamiast filtrować obiekty programu PowerShell po ich pobraniu. Ciąg filtru jest przekazywany do interfejsu API .NET w celu wyliczenia plików. Interfejs API obsługuje * tylko symbole wieloznaczne i ? .

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

-FollowSymlink

Domyślnie polecenie Get-ChildItem cmdlet wyświetla symboliczne linki do katalogów znalezionych podczas rekursji, ale nie jest w nich powtarzane. Użyj parametru FollowSymlink , aby wyszukać katalogi, które dotyczą tych linków symbolicznych. FollowSymlink jest parametrem dynamicznym i jest obsługiwany tylko w dostawcy systemu plików.

Ten parametr został wprowadzony w programie PowerShell 6.0.

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

-Force

Umożliwia poleceniem cmdlet pobranie elementów, do których w przeciwnym razie użytkownik nie może uzyskać dostępu, takich jak ukryte lub systemowe pliki. Parametr Force nie zastępuje ograniczeń zabezpieczeń. Implementacja różni się między dostawcami. Aby uzyskać więcej informacji, zobacz about_Providers.

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

-Hidden

Aby uzyskać tylko ukryte elementy, użyj parametru Hidden lub parametru Attributes z właściwością Hidden . Domyślnie Get-ChildItem nie wyświetla ukrytych elementów. Użyj parametru Force , aby pobrać ukryte elementy.

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

-Include

Określa tablicę z co najmniej jednym wzorcem ciągów, które mają być dopasowane, ponieważ polecenie cmdlet pobiera elementy podrzędne. Wszystkie pasujące elementy są uwzględniane w danych wyjściowych. Wprowadź element ścieżki lub wzorzec, taki jak "*.txt". Dozwolone są symbole wieloznaczne. Parametr Include jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość C:\Windows katalogu.

Parametry Include i Exclude mogą być używane razem. Jednak wykluczenia są stosowane po włączeniu, które mogą mieć wpływ na końcowe dane wyjściowe.

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

-LiteralPath

Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiterałuPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w znaki pojedynczego cudzysłowu. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

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

-Name

Pobiera tylko nazwy elementów w lokalizacji. Dane wyjściowe to obiekt ciągu, który można wysłać w dół potoku do innych poleceń. Dozwolone są symbole wieloznaczne.

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

-Path

Określa ścieżkę do co najmniej jednej lokalizacji. Akceptowane są symbole wieloznaczne. Domyślna lokalizacja to bieżący katalog (.).

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

-ReadOnly

Aby uzyskać tylko elementy tylko do odczytu, użyj parametru ReadOnly lub parametru AtrybutyReadOnly .

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

-Recurse

Pobiera elementy w określonych lokalizacjach i we wszystkich podrzędnych elementach lokalizacji.

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

-System

Pobiera tylko pliki systemowe i katalogi. Aby uzyskać tylko pliki systemowe i foldery, użyj właściwości System parametru systemowego lub atrybutów.

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

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę do Get-ChildItem.

Dane wyjściowe

Object

Typ zwracanego obiektu Get-ChildItem jest określany przez obiekty w ścieżce dysku dostawcy.

String

Jeśli używasz parametru Name , Get-ChildItem zwraca nazwy obiektów jako ciągi.

Uwagi

Get-ChildItem można uruchomić przy użyciu dowolnych wbudowanych aliasów, ls, diri gci. Aby uzyskać więcej informacji, zobacz about_Aliases.
Get-ChildItem domyślnie nie pobiera ukrytych elementów. Aby uzyskać ukryte elementy, użyj parametru Force .
Polecenie Get-ChildItem cmdlet jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.

Udostępnij za pośrednictwem

Get-ChildItem

Składnia

Opis

Przykłady

Przykład 1. Pobieranie elementów podrzędnych z katalogu systemu plików

Przykład 2. Pobieranie nazw elementów podrzędnych w katalogu

Przykład 3. Pobieranie elementów podrzędnych w bieżącym katalogu i podkatalogach

Przykład 4. Pobieranie elementów podrzędnych przy użyciu parametru Include

Przykład 5. Pobieranie elementów podrzędnych przy użyciu parametru Exclude

Przykład 6. Pobieranie kluczy rejestru z gałęzi rejestru

Przykład 7. Pobieranie wszystkich certyfikatów za pomocą urzędu podpisywania kodu

Przykład 8. Pobieranie elementów przy użyciu parametru Głębokość

Przykład 9. Uzyskiwanie twardych informacji o linkach

Przykład 10: dane wyjściowe dla systemów operacyjnych innych niż Windows

Przykład 11 — pobieranie elementu docelowego łącza dla punktu skrzyżowania

Parametry

-Attributes

-Depth

-Directory

-Exclude

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-System

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Get-ChildItem

Składnia

Opis

Przykłady

Przykład 1. Pobieranie elementów podrzędnych z katalogu systemu plików

Przykład 2. Pobieranie nazw elementów podrzędnych w katalogu

Przykład 3. Pobieranie elementów podrzędnych w bieżącym katalogu i podkatalogach

Przykład 4. Pobieranie elementów podrzędnych przy użyciu parametru Include

Przykład 5. Pobieranie elementów podrzędnych przy użyciu parametru Exclude

Przykład 6. Pobieranie kluczy rejestru z gałęzi rejestru

Przykład 7. Pobieranie wszystkich certyfikatów za pomocą urzędu podpisywania kodu

Przykład 8. Pobieranie elementów przy użyciu parametru Głębokość

Przykład 9. Uzyskiwanie twardych informacji o linkach

Przykład 10: dane wyjściowe dla systemów operacyjnych innych niż Windows

Przykład 11 — pobieranie elementu docelowego łącza dla punktu skrzyżowania

Parametry

-Attributes

-Depth

-Directory

-Exclude

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-System

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby