Get-ChildItem
Belirtilen bir veya daha fazla konumdaki öğeleri ve alt öğeleri alır.
Sözdizimi
Items EnterprisePublishing
Get-ChildItem
[[-Path] <string[]>]
[[-Filter] <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint>]
[-Force]
[-Name]
[<CommonParameters>]
LiteralItems
Get-ChildItem
[[-Filter] <string>]
-LiteralPath <string[]>
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-Depth <uint>]
[-Force]
[-Name]
[<CommonParameters>]
Description
Get-ChildItem cmdleti, belirtilen bir veya daha fazla konumdaki öğeleri elde eder. Öğ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 Yineleme parametresini kullanabilir ve yinelenen düzey sayısını sınırlamak için Derinlik parametresini kullanabilirsiniz.
Get-ChildItem boş dizinleri görüntülemez.
Get-ChildItem komutu Derinlik veya Yineleme parametrelerini içerdiğinde, boş dizinler çıkışa dahil değildir.
Get-ChildItem cmdlet'i herhangi bir sağlayıcı tarafından kullanıma sunulan öğelerle çalışacak şekilde tasarlanmıştır. Örneğin, öğeler bir dosya sistemi dosyası veya dizini, kayıt defteri kovanı veya sertifika deposu olabilir. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvider komutunu kullanın. 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.
Get-ChildItem cmdlet'i dizinini belirtmek için C:\Test 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 modu (Öznitelikler), LastWriteTime, dosya boyutu (Uzunluk) ve öğenin Adı listeler.
Modu özelliğindeki harfler aşağıdaki gibi yorumlanabilir:
-
l(bağlantı) -
d(dizin) -
a(arşiv) -
r(yalnızca okunabilir) -
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ı listelenir.
Get-ChildItem cmdlet'i dizinini belirtmek için C:\Test parametresini kullanır.
Adı 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 dizinde ve alt dizinlerde alt öğeleri alma
Bu örnekte, geçerli dizinde ve alt dizinlerinde bulunan .txt dosyalar görüntülenir.
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
Get-ChildItem cmdlet'i belirtmek için C:\Test\*.txt parametresini kullanır.
Yol, *dosya adı uzantısına sahip tüm dosyaları belirtmek için yıldız işareti (.txt) joker karakterini kullanır.
Yineleme parametresi, Dizini: başlıklarında gösterildiği gibi Yolu dizininde ve alt dizinlerinde şu şekilde aramalar yapar.
Zorlama parametresi, hiddenfile.txtmoduna sahip olan gibi 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 parametresini kullanı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
Get-ChildItem cmdlet'i dizinini belirtmek için C:\Test parametresini kullanır.
Path parametresi, bir dizin içeriğini belirtmek için sonuna eklenen joker karakteri olarak yıldız işaretini (*) içerir.
Include parametresi, *dosya adı uzantısına sahip tüm dosyaları belirtmek için yıldız işareti (.txt) joker karakteri kullanır.
Include parametresi kullanıldığında, Path parametresinin dizinin içeriğini belirtmek için sonda bir yıldız işareti (*) joker karakterine ihtiyaç vardır. Örneğin, -Path C:\Test\*.
-
Yineleme parametresi komuta eklenirse,
*parametresindeki sondaki yıldız işareti () isteğe bağlıdır. Yineleme parametresi, Yolu dizininden ve alt dizinlerinden öğeleri alır. Örneğin,-Path C:\Test\ -Recurse -Include *.txt -
*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ı, C:\Test\Logsdizininin içeriğini gösterir. Çıkış, Exclude ve Recurse parametrelerini kullanan diğer komutlar için bir referanstır.
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 cmdlet'i dizinini belirtmek için C:\Test\Logs parametresini kullanır.
Exclude parametresi, * veya A ile başlayan dosya veya dizinlerin çıktıdan hariç tutulduğunu belirtmek için yıldız işareti (a) joker karakterini kullanır.
Exclude parametresi kullanıldığında, * parametresinde sondaki yıldız işareti () isteğe bağlıdır. Örneğin, -Path C:\Test\Logs veya -Path C:\Test\Logs\*.
-
*parametresinde sondaki yıldız işareti () yoksa, Yol 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. -
*parametresinde sondaki yıldız işareti () varsa, 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 parametresi sonda yıldız işareti (
*) bulunsa da olmasa da özyineleme çıkışı aynıdır.
Örnek 6: Kayıt defteri anahtarlarını bir kayıt defteri kovanından alma
Bu örnek, HKEY_LOCAL_MACHINE\HARDWARE'den tüm kayıt defteri anahtarlarını alır.
Get-ChildItem
Path parametresini kullanarak HKLM:\HARDWAREkayıt defteri anahtarını belirtir. PowerShell konsolunda, kovanın yolu ve en üst düzey kayıt defteri anahtarları görüntülenir.
Daha fazla bilgi için bakınız 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, HKLM:\HARDWARE kayıt defteri anahtarının içeriğini gösterir.
Exclude parametresi, Get-ChildItemD*ile başlayan hiçbir alt anahtar döndürmemelerini söyler. Şu anda Exclude parametresi yalnızca alt anahtarlarda çalışır, öğe özelliklerinde çalışmaz.
Örnek 7: Kod imzalama yetkilisiyle tüm sertifikaları alma
Bu örnek, powershell Cert: sürücüsünde kod imzalama yetkilisi olan her sertifikayı alır.
Get-ChildItem cmdlet'i, sürücüsüyle Sertifika sağlayıcısını belirtmek için Cert: parametresini kullanır.
Özyineleme parametresi, Path ile belirtilen dizin ve alt dizinlerinde arama yapar.
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üsü 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. Derinlik 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
Get-ChildItem cmdlet'i belirtmek için C:\Parent parametresini kullanır.
Derinlik parametresi iki özyineleme düzeyi belirtir.
Get-ChildItem, Path parametresi ve iki alt dizin düzeyi tarafından belirtilen dizinin içeriğini 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 sistemlerinde 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
Artık çıkışın parçası olan yeni özellikler şunlardır:
- UnixMode, unix sisteminde gösterildiği gibi dosya izinleridir
- Kullanıcı dosya sahibidir
- Grup grup sahibidir
- Boyut, bir Unix sisteminde gösterildiği gibi dosya veya dizinin boyutudur
Uyarı
Bu özellik PowerShell 7.1'de deneyselden temele taşındı.
Örnek 11: Birleşim noktası için bağlantı hedefini alma
Windows Komut Kabuğu'ndaki dir komutu, bir dosya sistemi birleşim noktasının hedef konumunu gösterir. PowerShell'de bu bilgiler, tarafından döndürülen dosya sistemi nesnesinin Get-ChildItem ö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-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
Örnek 12: AppX yeniden ayrıştırma noktası için bağlantı hedefini alma
Bu örnek bir AppX yeniden ayrıştırma noktası için hedef bilgileri almayı dener. Microsoft Store uygulamaları, kullanıcının AppData dizininde AppX yeniden ayrıştırma noktaları oluşturur.
Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
Select-Object Mode, LinkTarget, LinkType, Name
Mode LinkTarget LinkType Name
---- ---------- -------- ----
la--- MicrosoftEdge.exe
Şu anda, Windows bir AppX bağlantı noktası için hedef bilgileri almak üzere bir yol sağlamaz. Dosya sistemi nesnesinin LinkTarget ve LinkType özellikleri boş.
Parametreler
-Attributes
Uyarı
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 karmaşık öznitelik birleşimleri 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
Yaygın olarak kullanılan özniteliklere sahip dosya ve klasörleri bulmak için Öznitelikleri parametresini kullanın. Veya, Directory, Dosya, Gizli, ReadOnlyve Systemparametreleri.
Öznitelikleri parametresi aşağıdaki değerleri destekler:
ArchiveCompressedDeviceDirectoryEncryptedHiddenIntegrityStreamNormalNoScrubDataNotContentIndexedOfflineReadOnlyReparsePointSparseFileSystemTemporary
Bu özniteliklerin açıklaması için FileAttributes numaralandırmasına bakın.
Öznitelikleri birleştirmek için aşağıdaki işleçleri kullanın:
-
!(DEĞİl) -
+(VE) -
,(VEYA)
bir iş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)
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Kabul edilen değerler: | Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-CodeSigningCert
Uyarı
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Code Signing özellik değerinde olan sertifikaların listesini almak için CodeSigningCert parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Depth
Bu parametre PowerShell 5.0'a eklendi ve özyineleme derinliğini denetlemenizi sağlar. Varsayılan olarak, Get-ChildItem ana dizin klasörünün içeriğini görüntüler.
Derinlik parametresi özyinelemede yer alan alt dizin düzeylerinin sayısını belirler ve içeriği görüntüler.
Örneğin, -Depth 2Path parametresinin dizinini, ilk alt dizin düzeyini ve ikinci alt dizin düzeyini içerir. Varsayılan olarak dizin adları ve dosya adları çıktıya eklenir.
Uyarı
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.
Parametre özellikleri
| Tür: | UInt32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Directory
Uyarı
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Dizinlerin listesini almak için Directory özelliğiyle Directory parametresini veya Öznitelikleri parametresini kullanın. Recurse parametresini Directoryile kullanabilirsiniz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | ilan |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DnsName
Uyarı
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 Unicode veya ASCIIolabilir. 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ı
Parametre özellikleri
| Tür: | DnsNameRepresentation |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DocumentEncryptionCert
Uyarı
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Document Encryption özellik değerinde olan sertifikaların listesini almak için DocumentEncryptionCert parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Eku
Uyarı
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ı
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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.
*.txt veya A*gibi bir yol öğesi veya deseni girin.
Joker karakterler kabul edilir.
* parametresindeki sondaki yıldız işareti () isteğe bağlıdır. Örneğin, -Path C:\Test\Logs veya -Path C:\Test\Logs\*. Sondaki yıldız işareti (*) eklenirse, komut Path parametresinin alt dizinlerine doğru ilerler. Yıldız işareti olmadan (*), Path parametresinin içeriği görüntülenir. Diğer ayrıntılar Örnek 5'e ve Notlar bölümüne eklenmiştir.
Dahil ve Hariç parametreleri birlikte kullanılabilir. Ancak dışlamalar eklemelerden sonra uygulanır ve bu da son çıkışı etkileyebilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ExpiringInDays
Uyarı
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Cmdlet'in yalnızca belirtilen sayıda gün içinde veya daha önce 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ı
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-File
Uyarı
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Dosyaların listesini almak için Dosya parametresini kullanın. Dosyaile Yineleme parametresini kullanabilirsiniz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | af |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 alırken nesneleri filtreler, böylece PowerShell nesneleri aldıktan sonra filtreleme yapmaz. Filtre dizesi dosyaları listelemek için .NET API'sine geçirilir. API yalnızca * ve ? joker karakterlerini destekler.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-FollowSymlink
Uyarı
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Varsayılan olarak, Get-ChildItem cmdlet'i, özyineleme sırasında bulunan dizinlere sembolik bağlantılar görüntüler, ancak onların içine girmez. 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Cmdlet'in gizli veya sistem dosyaları gibi kullanıcı tarafından erişilmeyen öğeleri almasına izin verir. Güç parametresi güvenlik kısıtlamalarını geçersiz kılmaz. Uygulama sağlayıcıya göre değişir. Daha fazla bilgi için bkz. about_Providers.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Hidden
Uyarı
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Yalnızca gizli öğeleri almak için Hidden parametresini veya Hidden özelliğiyle Öznitelikleri parametresini kullanın. Varsayılan olarak, Get-ChildItem gizli öğeleri görüntülemez. Gizli öğeleri almak için Zorla parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | ey, h |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
"*.txt"gibi bir yol öğesi veya deseni girin.
Joker karakterlere izin verilir.
Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.
Dahil ve Hariç parametreleri birlikte kullanılabilir. Ancak dışlamalar eklemelerden sonra uygulanır ve bu da son çıkışı etkileyebilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralItems
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Bir veya daha fazla konumun yolunu belirtir. Belirtilmezse, varsayılan konum geçerli dizindir (.). Joker karakterler kabul edilir.
Path parametresini Yineleme parametresiyle kullanırken dikkatli olun. Daha fazla bilgi için bu makalenin NOTLAR bölümüne bakın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | Current directory |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Items
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ReadOnly
Uyarı
Bu parametre yalnızca FileSystem sağlayıcısında kullanılabilir.
Sadece salt okunur öğeleri almak için ReadOnly parametresini veya Öznitelikler parametresindeki ReadOnly özelliğini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Ar |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Recurse
Belirtilen konumlardaki ve konumların tüm alt öğelerindeki öğeleri alır.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | s, r |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SSLServerAuthentication
Uyarı
Bu parametre yalnızca Sertifika sağlayıcısında kullanılabilir.
Server Authentication özellik değerinde olan sertifikaların listesini almak için SSLServerAuthentication parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-System
Uyarı
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 System parametresini veya Öznitelikleri parametresini ya da System özelliğini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | gibi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.
Çıkışlar
AliasInfo
Cmdlet, Alias: sürücüsüne erişirken bu türden bir çıktı üretir.
X509StoreLocation
X509Store
X509Certificate2
Cmdlet, Cert: sürücüsüne erişirken bu türlerin çıktısını verir.
DictionaryEntry
Cmdlet, Env: sürücüsüne erişirken bu türden bir çıktı üretir.
DirectoryInfo
FileInfo
Cmdlet, FileSystem sürücülerine erişirken bu türlerin çıkışını oluşturur.
FunctionInfo
FilterInfo
cmdlet, Function: sürücülerine erişirken bu türlerin çıktısını verir.
RegistryKey
Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür bir çıktı üretir.
PSVariable
cmdlet, Variable: sürücülerine erişirken bu tür çıkışlar yapar.
WSManConfigContainerElement
WSManConfigLeafElement
cmdlet, WSMan: sürücülerine erişirken bu türlerin çıktısını verir.
String
Adı parametresini kullandığınızda, bu cmdlet nesne adlarını dize olarak döndürür.
Notlar
PowerShell, Get-ChildItemiçin aşağıdaki diğer adları içerir:
- Tüm platformlar:
-
dir,gci
-
- Windows:
ls
Path parametresiyle Özyineleme davranışını :
Get-ChildItem -Recurse parametresiyle kullandığınızda, cmdlet joker karakter deseni veya değişmez değer adı olsun ya da olmasın son yol bileşenini arar.
- Son yol bileşeni hedef dizinin mevcut bir anlık alt diziniyle eşleşiyorsa, cmdlet eşleşen dizinde özyinelemeli numaralandırma gerçekleştirir.
- Son yol bileşeni hedef dizinin mevcut bir anlık alt diziniyle eşleşmiyorsa, cmdlet hedef dizinin hiyerarşisinde son yol bileşeniyle eşleşen öğeleri yinelemeli olarak arar
Get-ChildItem -Recurse ve Adı parametreleriyle kullandığınızda, davranış değişir. komut, hedef dizinin hemen alt öğeleri arasında son yol bileşenini arar.
- Anlık alt öğeler arasında bir eşleşme varsa, cmdlet eşleşen öğelerde özyinelemeli numaralandırma gerçekleştirir. Joker karakter eşleştirme, hedef dizinin en üst düzeyinde yalnızca bir kez gerçekleşir. Sonuçlar tek tek LiteralPath parametresine geçirilmiş gibi işlenir.
- Son yol bileşeni en üst düzeydeki hiçbir öğeyle eşleşmiyorsa bir hata oluşur.
Path parametresini Yineleme parametresiyle kullanmaktan kaçınmanız gerekir. En iyi sonuçlar için:
- Son yol bileşeni için özyinelemeli arama tetiklememek için hedef dizini belirtmek için LiteralPath kullanın.
- Hedef dizinin hiyerarşisinin her düzeyinde aranması gereken joker karakter veya değişmez değer desenlerini belirtmek için Filtre kullanın veya parametreleri ekleyin.
