Get-ChildItem
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 <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>]
Opis
Polecenie cmdlet Get-ChildItem
pobiera elementy w jednej lub więcej określonych lokalizacjach. Jeśli element jest kontenerem, otrzymuje 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 Depth, aby ograniczyć liczbę poziomów rekursji.
Get-ChildItem
nie wyświetla pustych katalogów. Gdy polecenie Get-ChildItem
zawiera parametry głębokości lub rekursji , puste katalogi nie są uwzględniane w danych wyjściowych.
Lokalizacje są ujawniane pod oznaczeniem Get-ChildItem
przez dostawców PowerShell. Lokalizacją może być katalog systemu plików, gałąź rejestru lub magazyn certyfikatów. Niektóre parametry są dostępne tylko dla określonego dostawcy. 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 wraca do wiersza polecenia programu PowerShell.
Polecenie cmdlet Get-ChildItem
używa parametru ścieżki w celu 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ść) oraz nazwa elementu. Litery w Mode właściwości 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 cmdlet Get-ChildItem
używa parametru ścieżki w celu określenia katalogu C:\Test
. Parametr Nazwa zwraca tylko nazwy plików lub katalogów z określonej ścieżki. Zwracane nazwy są względne względem wartości parametru Path.
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 wyświetlane są pliki .txt
znajdujące się w bieżącym katalogu i jego podkatalogach.
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
Polecenie cmdlet Get-ChildItem
używa parametru Ścieżka w celu określenia C:\Test\*.txt
.
ścieżka używa gwiazdki (*
) do określenia wszystkich plików z rozszerzeniem .txt
. Parametr Recurse wyszukuje katalog ścieżki i jego podkatalogów, jak pokazano w nagłówkach Directory:. Parametr Force wyświetla ukryte pliki, takie jak hiddenfile.txt
, które mają tryb h.
Przykład 4: Pobieranie elementów podrzędnych przy użyciu parametru Include
W tym przykładzie Get-ChildItem
używa parametru Include w celu znalezienia określonych elementów 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 cmdlet Get-ChildItem
używa parametru ścieżki w celu określenia katalogu C:\Test
. Parametr Path zawiera gwiazdkę jako znak wieloznaczny na końcu (*
), aby określić zawartość katalogu.
Parametr Include używa gwiazdki (*
) symbol wieloznaczny, aby określić wszystkie pliki z rozszerzeniem nazwy pliku .txt
.
Gdy używany jest parametr Include, parametr Path wymaga końcowej gwiazdki (*
) aby określić zawartość katalogu. Na przykład -Path C:\Test\*
.
- Jeśli parametr Recurse zostanie dodany do polecenia, końcowa gwiazdka (
*
) w parametrze ścieżki jest opcjonalna. Parametr Recurse pobiera elementy z katalogu Path oraz 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 przedstawiają zawartość katalogu C:\Test\Logs
. Dane wyjściowe to odwołanie do innych poleceń, które używają parametrów Exclude i 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
Polecenie cmdlet Get-ChildItem
używa parametru ścieżki w celu określenia katalogu C:\Test\Logs
. Parametr Exclude używa gwiazdki (*
) jako symbolu wieloznacznego do określenia, że dowolne pliki lub katalogi rozpoczynające się od A
lub a
są wykluczone z danych wyjściowych.
Jeśli jest używany parametr Exclude, końcowa gwiazdka (*
) w parametrze Ścieżka jest opcjonalna. Na przykład -Path C:\Test\Logs
lub -Path C:\Test\Logs\*
.
- Jeśli w parametrze ścieżki
*
nie znajduje się gwiazdka na końcu (), zostanie wyświetlona zawartość parametru ścieżki . Wyjątki to nazwy plików lub podkatalogów, które są zgodne z wartością parametru Exclude. - Jeśli w parametrze
*
znajduje się końcowa gwiazdka (), polecenie wchodzi w podkatalogi parametru Path. Wyjątki to nazwy plików lub podkatalogów, które są zgodne z wartością parametru Exclude. - Jeśli parametr Recurse zostanie dodany do polecenia, dane wyjściowe rekursji są takie same, niezależnie od tego, czy parametr Path zawiera na końcu gwiazdkę (
*
).
Przykład 6: Uzyskaj klucze rejestru z gałęzi rejestru
Ten przykład pobiera wszystkie klucze rejestru z HKEY_LOCAL_MACHINE\HARDWARE
.
Get-ChildItem
używa parametru ścieżka w celu określenia klucza rejestru HKLM:\HARDWARE
. Ścieżka hive i najwyższy poziom kluczy rejestru są wyświetlane w konsoli programu PowerShell.
Więcej informacji znajdziesz w 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ść klucza rejestru HKLM:\HARDWARE
. Parametr Exclude informuje, aby Get-ChildItem
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 z uprawnieniami do podpisywania kodu
Ten przykład pobiera każdy certyfikat z dysku Cert:
programu PowerShell, który ma uprawnienia do podpisywania kodu.
Polecenie cmdlet Get-ChildItem
używa parametru do wskazania dostawcy certyfikatu ze ścieżką na dysku Cert:
. Parametr Recurse wyszukuje katalog podany przez Path i jego podkatalogi. Parametr CodeSigningCert pobiera tylko certyfikaty, które mają uprawnienia do 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 przedstawiono elementy w katalogu i jego podkatalogach. Parametr Głębokość określa liczbę poziomów podkatalogów uwzględnianych 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 cmdlet Get-ChildItem
używa parametru Ścieżka w celu określenia C:\Parent
. Parametr głębokości określa dwa poziomy rekursji.
Get-ChildItem
wyświetla zawartość katalogu określonego przez parametr Path oraz dwa poziomy podkatalogów.
Przykład 9: Uzyskiwanie informacji o twardych linkach
W programie PowerShell 6.2 dodano widok alternatywny, aby uzyskać twarde informacje o linkach.
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 Unix Get-ChildItem
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 oznacza uprawnienia do plików w systemie Unix
- użytkownik jest właścicielem pliku
- grupa jest właścicielem grupy
- rozmiar jest rozmiarem pliku lub katalogu reprezentowanego w systemie Unix
Notatka
Ta funkcja została przeniesiona z eksperymentalnego do głównego nurtu w programie PowerShell 7.1.
Przykład 11: Pobieranie celu łącza dla punktu połączenia
Polecenie dir
w powłoce poleceń systemu Windows pokazuje lokalizację docelową 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óconej 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-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
Przykład 12: Pobieranie docelowego elementu linku dla punktu ponownego przypisania AppX
W tym przykładzie próbuje się uzyskać docelowe informacje dla punktu ponownego analizowania AppX. Aplikacje Microsoft Store tworzą punkty ponownej analizy AppX w katalogu AppData użytkownika.
Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
Select-Object Mode, LinkTarget, LinkType, Name
Mode LinkTarget LinkType Name
---- ---------- -------- ----
la--- MicrosoftEdge.exe
W tej chwili system Windows nie zapewnia sposobu na uzyskanie informacji docelowych dla punktu ponownego przetwarzania AppX. Właściwości LinkTarget i LinkType obiektu systemu plików są puste.
Parametry
-Attributes
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
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 inne niż systemowe (nie katalogi), które są szyfrowane 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 Attributes. Albo parametry Directory, File, Hidden, ReadOnlyi System.
Parametr atrybutów obsługuje następujące właściwości:
- archiwum
- skompresowane
- urządzenie
- Katalog
- Zaszyfrowany
- Ukryte
- IntegrityStream
- — normalny
- NoScrubData
- NotContentIndexed
- w trybie offline
- Tylko do odczytu
- ReparsePoint
- rzadki plik
- System
- tymczasowe
Aby uzyskać opis tych atrybutów, zobacz FileAttributes wyliczenie.
Aby połączyć atrybuty, użyj następujących operatorów:
-
!
(NIE) -
+
(AND) -
,
(OR)
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)
Typ: | FlagsExpression<T>[FileAttributes] |
Dopuszczalne wartości: | Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-CodeSigningCert
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Aby uzyskać listę certyfikatów, które mają Code Signing
w wartości właściwości EnhancedKeyUsageList, użyj parametru CodeSigningCert.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 podkatalogu, które są uwzględnione w rekursji i wyświetla zawartość.
Na przykład -Depth 2
zawiera 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.
Notatka
Na komputerze z systemem Windows, z poziomu PowerShell lub cmd.exe, można uzyskać graficzny przegląd struktury katalogów za pomocą polecenia tree.com.
Typ: | UInt32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Directory
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
Aby uzyskać listę katalogów, użyj parametru Katalog lub parametru Atrybuty z właściwością Katalog. Możesz użyć parametru Recurse z Directory.
Typ: | SwitchParameter |
Aliasy: | ad |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DnsName
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Określa nazwę domeny lub jej wzorzec do dopasowania z właściwością DNSNameList certyfikatów pobieranych przez polecenie cmdlet. Wartość tego parametru może być Unicode
lub ASCII
. Wartości punycode są konwertowane na Unicode. Dozwolone są symbole wieloznaczne (*
).
Ten parametr został przywrócony w programie PowerShell 7.1
Typ: | DnsNameRepresentation |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-DocumentEncryptionCert
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Aby uzyskać listę certyfikatów, które mają Document Encryption
w wartości właściwości EnhancedKeyUsageList, użyj parametru DocumentEncryptionCert.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Eku
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Określa tekst lub wzorzec tekstu, który ma być zgodny z właściwością EnhancedKeyUsageList certyfikatów pobieranych przez polecenie cmdlet. Dozwolone są symbole wieloznaczne (*
). Właściwość EnhancedKeyUsageList zawiera przyjazną nazwę i pola OID EKU.
Ten parametr został przywrócony w programie PowerShell 7.1
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-Exclude
Określa tablicę z co najmniej jednym wzorcem ciągów, które mają być dopasowane podczas pobierania elementów podrzędnych przez polecenie cmdlet. 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 Path 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 można znaleźć w sekcji Przykład 5 i Uwagi.
Parametry Include i Exclude można używać razem. Jednak wykluczenia są stosowane po włączeniu, co może mieć wpływ na końcowe dane wyjściowe.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-ExpiringInDays
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Określa, że polecenie cmdlet powinno zwracać tylko certyfikaty, które wygasną w ciągu lub przed określoną liczbą dni. Wartość zerowa (0
) uzyskuje wygasłe certyfikaty.
Ten parametr został przywrócony w programie PowerShell 7.1
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-File
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
Aby uzyskać listę plików, użyj parametru File. Możesz zastosować parametr Recurse w połączeniu z File.
Typ: | SwitchParameter |
Aliasy: | af |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Filter
Określa filtr, aby zakwalifikować parametr ścieżki. Dostawca FileSystem jest jedynym zainstalowanym dostawcą programu PowerShell obsługującym filtry. Filtry są bardziej wydajne niż inne parametry. Dostawca zastosowuje filtr, gdy polecenie cmdlet pobiera obiekty, zamiast pozwalać, by program PowerShell filtrował obiekty po ich pobraniu. Ciąg filtru jest przekazywany do interfejsu API platformy .NET w celu wyliczenia plików. Interfejs API obsługuje tylko symbole wieloznaczne *
i ?
.
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-FollowSymlink
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
Domyślnie polecenie cmdlet Get-ChildItem
wyświetla linki symboliczne do katalogów znalezionych podczas rekursji, ale nie wchodzi do nich. 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.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Force
Umożliwia polecenie cmdlet uzyskanie dostępu do elementów, do których użytkownik w przeciwnym razie by nie miał dostępu, takich jak pliki ukryte lub systemowe. Parametr Force nie zastępuje ograniczeń zabezpieczeń. Implementacja różni się między dostawcami. Aby uzyskać więcej informacji, zobacz about_Providers.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Hidden
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
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 uzyskać ukryte elementy.
Typ: | SwitchParameter |
Aliasy: | ah, h |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Include
Określa tablicę z co najmniej jednym wzorcem ciągów, które mają być dopasowane podczas pobierania elementów podrzędnych przez polecenie cmdlet. 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ść katalogu C:\Windows
.
Parametry Include i Exclude można używać razem. Jednak wykluczenia są stosowane po włączeniu, co może mieć wpływ na końcowe dane wyjściowe.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-LiteralPath
Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiteralPath jest używana dokładnie tak, jak jest typowana. Żadne znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze cudzysłowy informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Aby uzyskać więcej informacji, zajrzyj do about_Quoting_Rules.
Typ: | String[] |
Aliasy: | PSPath, LP |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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ń. Zwracane nazwy są względne względem wartości parametru Path.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Path
Określa ścieżkę do co najmniej jednej lokalizacji. Symbole wieloznaczne są akceptowane. Domyślną lokalizacją jest bieżący katalog (.
).
Typ: | String[] |
Position: | 0 |
Domyślna wartość: | Current directory |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | True |
-ReadOnly
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
Aby uzyskać elementy tylko do odczytu, użyj parametru ReadOnly lub parametru Attributes właściwości ReadOnly.
Typ: | SwitchParameter |
Aliasy: | ar |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Recurse
Pobiera elementy w określonych lokalizacjach i we wszystkich elementach podrzędnych lokalizacji.
Typ: | SwitchParameter |
Aliasy: | s, r |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SSLServerAuthentication
Notatka
Ten parametr jest dostępny tylko u dostawcy certyfikatu.
Aby uzyskać listę certyfikatów, które mają Server Authentication
w wartości właściwości EnhancedKeyUsageList, użyj parametru SSLServerAuthentication.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-System
Notatka
Ten parametr jest dostępny tylko w dostawcy FileSystem.
Pobiera tylko pliki systemowe i katalogi. Aby uzyskać tylko pliki systemowe i foldery, użyj parametru System lub parametru atrybutów właściwości System.
Typ: | SwitchParameter |
Aliasy: | as |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Możesz przesłać jako strumień ciąg znaków zawierający ścieżkę do tego polecenia cmdlet.
Dane wyjściowe
Polecenie cmdlet zwraca ten typ podczas uzyskiwania dostępu do dysku Alias:
.
Polecenie cmdlet zwraca te typy podczas uzyskiwania dostępu do dysku Cert:
.
Polecenie cmdlet zwraca ten typ podczas uzyskiwania dostępu do dysku Env:
.
Polecenie cmdlet zwraca te typy podczas uzyskiwania dostępu do dysków systemu plików.
Cmdlet zwraca te typy podczas uzyskiwania dostępu do dysków Function:
.
Polecenie cmdlet zwraca ten typ podczas uzyskiwania dostępu do dysków rejestru.
Polecenie cmdlet zwraca ten typ podczas uzyskiwania dostępu do dysków Variable:
.
Cmdlet zwraca te typy podczas uzyskiwania dostępu do dysków WSMan:
.
Jeśli używasz parametru Name, to polecenie cmdlet zwraca nazwy obiektów jako ciągi.
Uwagi
Program PowerShell zawiera następujące aliasy dla Get-ChildItem
:
- Wszystkie platformy:
-
dir
,gci
-
- Windows:
ls
Get-ChildItem
domyślnie nie pobiera ukrytych elementów. Aby uzyskać ukryte elementy, użyj parametru Force.
Polecenie cmdlet Get-ChildItem
jest zaprojektowane do pracy z danymi udostępnionymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider
. Aby uzyskać więcej informacji, zobacz about_Providers.