Get-ChildItem
Belirtilen bir veya daha fazla konumdaki öğeleri ve alt öğeleri alır.
Syntax
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>]
Description
Cmdlet, Get-ChildItem
öğeleri belirtilen bir veya daha fazla konumda alır. Öğe bir kapsayıcıysa, kapsayıcının içindeki öğeleri (alt öğeler olarak bilinir) alır. Tüm alt kapsayıcılardaki öğeleri almak için Özyineleme parametresini kullanabilir ve yinelenen düzey sayısını sınırlamak için Depth parametresini kullanabilirsiniz.
Get-ChildItem
boş dizinleri görüntülemez. Bir Get-ChildItem
komut Derinlik veya Özyineleme parametrelerini içerdiğinde, boş dizinler çıkışa dahil değildir.
Konumlar PowerShell sağlayıcıları tarafından kullanıma sunulur Get-ChildItem
. Konum bir dosya sistemi dizini, kayıt defteri kovanı veya sertifika deposu olabilir. Bazı parametreler yalnızca belirli bir sağlayıcı için kullanılabilir. Daha fazla bilgi için bkz. about_Providers.
Örnekler
Örnek 1: Dosya sistemi dizininden alt öğeleri alma
Bu örnek, bir dosya sistemi dizininden alt öğeleri alır. Dosya adları ve alt dizin adları görüntülenir. Boş konumlar için komut herhangi bir çıkış döndürmez ve PowerShell istemine döner.
cmdlet'i Get-ChildItem
, dizinini C:\Test
belirtmek için Path parametresini kullanır.
Get-ChildItem
PowerShell konsolunda dosyaları ve dizinleri görüntüler.
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
Varsayılan olarak Get-ChildItem
mod (Öznitelikler), LastWriteTime, dosya boyutu (Uzunluk) ve öğenin adı listelenir. Mode özelliğindeki harfler aşağıdaki gibi yorumlanabilir:
l
(bağlantı)d
(dizin)a
(arşiv)r
(salt okunur)h
(gizli)s
(sistem).
Mod bayrakları hakkında daha fazla bilgi için bkz. about_Filesystem_Provider.
Örnek 2: Dizinde alt öğe adlarını alma
Bu örnekte yalnızca dizindeki öğelerin adları listelenmiştir.
cmdlet'i Get-ChildItem
, dizinini C:\Test
belirtmek için Path parametresini kullanır. Name parametresi yalnızca belirtilen yoldan dosya veya dizin adlarını döndürür. Döndürülen adlar Path parametresinin değerine göredir.
Get-ChildItem -Path C:\Test -Name
Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt
Örnek 3: Geçerli dizin ve alt dizinlerde alt öğeleri alma
Bu örnekte, geçerli dizinde ve alt dizinlerinde bulunan dosyalar görüntülenir .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
cmdlet'i Get-ChildItem
belirtmek C:\Test\*.txt
için Path parametresini kullanır. Yol, dosya adı uzantısına .txt
sahip tüm dosyaları belirtmek için yıldız işareti (*
) joker karakterini kullanır. Recurse parametresi, Dizin: başlıklarında gösterildiği gibi Path dizininde alt dizinlerinde aramalar. Force parametresi, h moduna sahip gibi hiddenfile.txt
gizli dosyaları görüntüler.
Örnek 4: Include parametresini kullanarak alt öğeleri alma
Bu örnekte Get-ChildItem
, Path parametresi tarafından belirtilen dizinden belirli öğeleri bulmak için Include parametresi kullanılır.
# 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
cmdlet'i Get-ChildItem
, dizinini C:\Test
belirtmek için Path parametresini kullanır. Path parametresi, dizinin içeriğini belirtmek için sondaki yıldız işareti (*
) joker karakterini içerir.
Include parametresi, dosya adı uzantısına .txt
sahip tüm dosyaları belirtmek için bir yıldız işareti (*
) joker karakteri kullanır.
Include parametresi kullanıldığında Path parametresinin dizinin içeriğini belirtmek için sondaki yıldız işareti (*
) joker karakteri gerekir. Örneğin, -Path C:\Test\*
.
- Özyineleme parametresi komuta eklenirse, Path parametresindeki sondaki yıldız işareti (
*
) isteğe bağlıdır. Recurse parametresi, Path dizininden ve alt dizinlerinden öğeleri alır. Örneğin,-Path C:\Test\ -Recurse -Include *.txt
- Path parametresinde sondaki yıldız işareti (
*
) yoksa, komut herhangi bir çıkış döndürmez ve PowerShell istemine döner. Örneğin,-Path C:\Test\
.
Örnek 5: Exclude parametresini kullanarak alt öğeleri alma
Örneğin çıktısı dizininin C:\Test\Logs
içeriğini gösterir. Çıkış, Exclude ve Recurse parametrelerini kullanan diğer komutların başvurusudur.
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
cmdlet'i Get-ChildItem
, dizinini C:\Test\Logs
belirtmek için Path parametresini kullanır. Exclude parametresi, çıkışla A
başlayan veya çıkıştan dışlanan dosyaları veya a
dizinleri belirtmek için yıldız işareti (*
) joker karakterini kullanır.
Exclude parametresi kullanıldığında, Path parametresinde sondaki yıldız işareti (*
) isteğe bağlıdır. Örneğin -Path C:\Test\Logs
veya -Path C:\Test\Logs\*
olabilir.
- Path parametresinde sondaki yıldız işareti (
*
) yoksa, Path parametresinin içeriği görüntülenir. Özel durumlar, Exclude parametresinin değeriyle eşleşen dosya adları veya alt dizin adlarıdır. - Path parametresine sondaki yıldız işareti (
*
) eklenirse, komut Path parametresinin alt dizinlerine yinelenir. Özel durumlar, Exclude parametresinin değeriyle eşleşen dosya adları veya alt dizin adlarıdır. - Özyineleme parametresi komuta eklenirse, Path parametresinin sonunda yıldız işareti (
*
) bulunsa da olmasa da özyineleme çıkışı aynıdır.
Örnek 6: Kayıt defteri kovanından kayıt defteri anahtarlarını alma
Bu örnek, 'den HKEY_LOCAL_MACHINE\HARDWARE
tüm kayıt defteri anahtarlarını alır.
Get-ChildItem
, kayıt defteri anahtarını HKLM:\HARDWARE
belirtmek için Path parametresini kullanır. Hive'ın yolu ve en üst kayıt defteri anahtarları düzeyi PowerShell konsolunda görüntülenir.
Daha fazla bilgi için bkz. 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
İlk komut, kayıt defteri anahtarının HKLM:\HARDWARE
içeriğini gösterir. Exclude parametresi ile D*
başlayan hiçbir alt anahtar döndürülmemesi gerektiğini bildirirGet-ChildItem
. Şu anda Exclude parametresi yalnızca alt anahtarlarda çalışır, öğe özelliklerinde çalışmaz.
Örnek 7: Kod imzalama yetkilisine sahip tüm sertifikaları alma
Bu örnek, PowerShell Cert:
sürücüsünde kod imzalama yetkilisi olan her sertifikayı alır.
cmdlet'i Get-ChildItem
, Sürücü ile Sertifika sağlayıcısını belirtmek için Path parametresini Cert:
kullanır. Recurse parametresi, Path ve alt dizinleri tarafından belirtilen dizinde arama sağlar. CodeSigningCert parametresi yalnızca kod imzalama yetkilisine sahip sertifikaları alır.
Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert
Sertifika sağlayıcısı ve Cert:
sürücü hakkında daha fazla bilgi için bkz. about_Certificate_Provider.
Örnek 8: Depth parametresini kullanarak öğeleri alma
Bu örnekte, bir dizindeki ve alt dizinlerindeki öğeler görüntülenir. Depth parametresi özyinelemede yer alacak alt dizin düzeylerinin sayısını belirler. Boş dizinler çıktının dışında tutulur.
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
cmdlet'i Get-ChildItem
belirtmek C:\Parent
için Path parametresini kullanır. Depth parametresi iki özyineleme düzeyini belirtir. Get-ChildItem
Path parametresi tarafından belirtilen dizinin içeriğini ve iki alt dizin düzeyini görüntüler.
Örnek 9: Sabit bağlantı bilgilerini alma
PowerShell 6.2'de, sabit bağlantı bilgilerini almak için alternatif bir görünüm eklendi.
Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink
Örnek 10: Windows Dışı İşletim Sistemleri için Çıkış
Unix sistemlerde PowerShell 7.1'de Get-ChildItem
Unix benzeri bir çıkış sağlar:
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
Çıkışın parçası olan yeni özellikler şunlardır:
- UnixMode , unix sisteminde gösterildiği gibi dosya izinleridir
- Kullanıcı dosya sahibidir
- Grup , grubun sahibidir
- Boyut , unix sisteminde gösterildiği gibi dosya veya dizinin boyutudur
Not
Bu özellik PowerShell 7.1'de deneyselden genele taşınmıştır.
Örnek 11 - Bağlantı noktası için bağlantı hedefini alma
dir
Windows Komut Kabuğu'ndaki komut, bir dosya sistemi birleşim noktasının hedef konumunu gösterir. PowerShell'de bu bilgiler tarafından döndürülen Get-ChildItem
dosya sistemi nesnesinin LinkTarget özelliğinden edinilebilir ve varsayılan çıktıda görüntülenir.
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
Parametreler
-Attributes
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Belirtilen özniteliklere sahip dosya ve klasörleri alır. Bu parametre tüm öznitelikleri destekler ve özniteliklerin karmaşık birleşimlerini belirtmenize olanak tanır.
Örneğin, şifrelenmiş veya sıkıştırılmış sistem dışı dosyaları (dizinleri değil) almak için şunu yazın:
Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed
Sık kullanılan özniteliklere sahip dosya ve klasörleri bulmak için Attributes parametresini kullanın. Veya Directory, File, Hidden, ReadOnly ve System parametreleri.
Attributes parametresi aşağıdaki özellikleri destekler:
- Arşiv
- Sıkıştırılmış
- Cihaz
- Dizin
- Şifreli
- Gizli
- IntegrityStream
- Normal
- NoScrubData
- NotContentIndexed
- Çevrimdışı
- Readonly
- ReparsePoint
- SparseFile
- Sistem
- Geçici
Bu özniteliklerin açıklaması için bkz. FileAttributes Sabit Listesi.
Öznitelikleri birleştirmek için aşağıdaki işleçleri kullanın:
!
(DEĞİl)+
(VE),
(VEYA)
İşleç ile özniteliği arasında boşluk kullanmayın. Boşluklar virgülden sonra kabul edilir.
Yaygın öznitelikler için aşağıdaki kısaltmaları kullanın:
D
(Dizin)H
(Gizli)R
(Salt okunur)S
(Sistem)
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CodeSigningCert
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
EnhancedKeyUsageList özellik değerindeki sertifikaların Code Signing
listesini almak için CodeSigningCert parametresini kullanın.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Bu parametre PowerShell 5.0'a eklendi ve özyineleme derinliğini denetlemenize olanak tanır. Varsayılan olarak, Get-ChildItem
üst dizinin içeriğini görüntüler. Depth parametresi özyinelemede yer alan alt dizin düzeylerinin sayısını belirler ve içeriği görüntüler.
Örneğin, -Depth 2
Path parametresinin dizinini, ilk alt dizin düzeyini ve ikinci alt dizin düzeyini içerir. Varsayılan olarak dizin adları ve dosya adları çıkışa eklenir.
Not
PowerShell'den veya cmd.exebir Windows bilgisayarında , tree.com komutuyla dizin yapısının grafik görünümünü görüntüleyebilirsiniz.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Dizinlerin listesini almak için Directory özelliğini kullanarakDirectory parametresini veya Attributes parametresini kullanın. Recurse parametresini Directory ile kullanabilirsiniz.
Type: | SwitchParameter |
Aliases: | ad |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DnsName
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Cmdlet'in aldığı sertifikaların DNSNameList özelliğiyle eşleşecek bir etki alanı adı veya ad deseni belirtir. Bu parametrenin değeri veya ASCII
olabilirUnicode
. Punycode değerleri Unicode'a dönüştürülür. Joker karakterlere (*
) izin verilir.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Type: | DnsNameRepresentation |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-DocumentEncryptionCert
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
EnhancedKeyUsageList özellik değerindeki sertifikaların Document Encryption
listesini almak için DocumentEncryptionCert parametresini kullanın.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Eku
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Cmdlet'in aldığı sertifikaların EnhancedKeyUsageList özelliğiyle eşleşecek metni veya metin desenini belirtir. Joker karakterlere (*
) izin verilir. EnhancedKeyUsageList özelliği, EKU'nun kolay adını ve OID alanlarını içerir.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Cmdlet alt öğeleri aldığında eşleştirilecek bir veya daha fazla dize deseni dizisini belirtir. Eşleşen öğeler çıktının dışında tutulur. veya gibi *.txt
A*
bir yol öğesi veya deseni girin.
Joker karakterler kabul edilir.
Path parametresinde sondaki yıldız işareti (*
) isteğe bağlıdır. Örneğin -Path C:\Test\Logs
veya -Path C:\Test\Logs\*
olabilir. Sondaki yıldız işareti (*
) eklenirse, komut Path parametresinin alt dizinlerine yinelenir. Yıldız ()*
olmadan Path parametresinin içeriği görüntülenir. Diğer ayrıntılar Örnek 5'te ve Notlar bölümünde yer almaktadır.
Include ve Exclude parametreleri birlikte kullanılabilir. Ancak, dışlamalar eklemelerden sonra uygulanır ve bu da son çıkışı etkileyebilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ExpiringInDays
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Cmdlet'in yalnızca belirtilen gün sayısı içinde veya öncesinde süresi dolan sertifikaları döndürmesi gerektiğini belirtir. Sıfır (0
) değeri süresi dolmuş sertifikaları alır.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Dosyaların listesini almak için Dosya parametresini kullanın. Dosya ile Özyineleme parametresini kullanabilirsiniz.
Type: | SwitchParameter |
Aliases: | af |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtreleri destekleyen tek yüklü PowerShell sağlayıcısıdır. Filtreler diğer parametrelerden daha verimlidir. Sağlayıcı, cmdlet nesneleri aldıktan sonra PowerShell'in nesneleri filtrelemesini yapmak yerine nesneleri aldığında filtre uygular. Filtre dizesi dosyaları listelemek için .NET API'sine geçirilir. API yalnızca ve ?
joker karakterlerini destekler*
.
Type: | String |
Position: | 1 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-FollowSymlink
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Varsayılan olarak, Get-ChildItem
cmdlet özyineleme sırasında bulunan dizinlere sembolik bağlantılar görüntüler, ancak bunlara yineleme yapmaz. Bu sembolik bağlantıları hedefleyen dizinlerde arama yapmak için FollowSymlink parametresini kullanın. FollowSymlink dinamik bir parametredir ve yalnızca FileSystem sağlayıcısında desteklenir.
Bu parametre PowerShell 6.0'da kullanıma sunulmuştur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Cmdlet'in gizli dosyalar veya sistem dosyaları gibi kullanıcı tarafından erişilmeyen öğeleri almasına izin verir. Force parametresi güvenlik kısıtlamalarını geçersiz kılmaz. Uygulama sağlayıcılar arasında farklılık gösterir. Daha fazla bilgi için bkz. about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Hidden
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Yalnızca gizli öğeleri almak için Hidden parametresini veya GizliözelliğiyleAttributes parametresini kullanın. Varsayılan olarak, Get-ChildItem
gizli öğeleri görüntülemez. Gizli öğeleri almak için Force parametresini kullanın.
Type: | SwitchParameter |
Aliases: | ah, h |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Cmdlet alt öğeleri aldığında eşleştirilecek bir veya daha fazla dize deseni dizisini belirtir. Eşleşen öğeler çıkışa eklenir. gibi "*.txt"
bir yol öğesi veya deseni girin.
Joker karakterlere izin verilir. Include parametresi yalnızca komut gibi C:\Windows\*
bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows
belirtir.
Include ve Exclude parametreleri birlikte kullanılabilir. Ancak, dışlamalar eklemelerden sonra uygulanır ve bu da son çıkışı etkileyebilir.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamasını söyler.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Yalnızca konumdaki öğelerin adlarını alır. Çıkış, işlem hattını diğer komutlara gönderilebilen bir dize nesnesidir. Döndürülen adlar Path parametresinin değerine göredir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Bir veya daha fazla konumun yolunu belirtir. Joker karakterler kabul edilir. Varsayılan konum geçerli dizindir (.
).
Type: | String[] |
Position: | 0 |
Default value: | Current directory |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-ReadOnly
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Yalnızca salt okunur öğeleri almak için ReadOnly parametresini veya Attributes parametresi ReadOnly özelliğini kullanın.
Type: | SwitchParameter |
Aliases: | ar |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recurse
Belirtilen konumlardaki ve konumların tüm alt öğelerindeki öğeleri alır.
Type: | SwitchParameter |
Aliases: | s |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSLServerAuthentication
Not
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
EnhancedKeyUsageList özellik değerinde bulunan Server Authentication
sertifikaların listesini almak için SSLServerAuthentication parametresini kullanın.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-System
Not
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Yalnızca sistem dosyalarını ve dizinlerini alır. Yalnızca sistem dosyalarını ve klasörlerini almak için Sistem parametresini veya Öznitelikler parametresi Sistem özelliğini kullanın.
Type: | SwitchParameter |
Aliases: | as |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.
Çıkışlar
Cmdlet, sürücüye erişirken bu tür çıkışlar Alias:
oluşturur.
cmdlet'i sürücüye erişirken bu türlerin çıkışını Cert:
alır.
Cmdlet, sürücüye erişirken bu tür çıkışlar Env:
oluşturur.
Cmdlet, Dosya Sistemi sürücülerine erişirken bu türlerin çıkışını yapar.
cmdlet'i sürücülere erişirken bu türlerin çıkışını Function:
yapar.
Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür çıkış yapar.
cmdlet'i sürücülere erişirken bu tür çıkış yapar Variable:
.
Microsoft.WSMan.Management.WSManConfigContainerElement
Microsoft.WSMan.Management.WSManConfigLeafElement
cmdlet'i sürücülere erişirken bu türlerin çıkışını WSMan:
yapar.
Name parametresini kullandığınızda, bu cmdlet nesne adlarını dize olarak döndürür.
Notlar
PowerShell, için Get-ChildItem
aşağıdaki diğer adları içerir:
- Tüm platformlar:
dir
,gci
- Windows:
ls
Get-ChildItem
varsayılan olarak gizli öğeleri almaz. Gizli öğeleri almak için Force parametresini kullanın.
Get-ChildItem
Cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PSProvider
. Daha fazla bilgi için bkz. about_Providers.
İlişkili Bağlantılar
Geri Bildirim
Gönderin ve geri bildirimi görüntüleyin