Get-ChildItem

Modül:

Microsoft.PowerShell.Management Module

Belirtilen bir veya daha fazla konumdaki öğeleri ve alt öğeleri alır.

Syntax

Items (Varsayılan)

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<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: 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.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $Env:TEMP
PS D:\> Get-ChildItem | Select-Object Name, *Target

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

Örnek 10: 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:

• Archive
• Compressed
• Device
• Directory
• Encrypted
• Hidden
• IntegrityStream
• Normal
• NoScrubData
• NotContentIndexed
• Offline
• ReadOnly
• ReparsePoint
• SparseFile
• System
• Temporary

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:	FlagsExpression<T>[FileAttributes]
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ı

Derinlik parametresi, Include parametresiyle kullanıldığında hiçbir etkiye sahip değildir. Bu sorunu geçici olarak çözmek için bunun yerine Filter parametresini kullanın. Bu, PowerShell 6 ve üzeri sürümlerde düzeltilmiştir.

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, d

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.

Uyarı

Include ve Exclude parametrelerinin LiteralPath parametresiyle kullanıldığında hiçbir etkisi olmaz. Bu, PowerShell 7'de düzeltildi.

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.

Uyarı

Include ve Exclude parametrelerinin LiteralPath parametresiyle kullanıldığında hiçbir etkisi olmaz. Bu, PowerShell 7'de düzeltildi.

Uyarı

Derinlik parametresi, Include parametresiyle kullanıldığında hiçbir etkiye sahip değildir. Bu sorunu geçici olarak çözmek için bunun yerine Filter parametresini kullanın. Bu, PowerShell 6'da düzeltildi.

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.

Uyarı

Include ve Exclude parametrelerinin LiteralPath parametresiyle kullanıldığında hiçbir etkisi olmaz. Bu, PowerShell 7'de düzeltildi.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	PSPath

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

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

-UseTransaction

Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	usetx

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

Windows PowerShell, Get-ChildItemiçin aşağıdaki diğer adları içerir:

• ls
• dir
• gci

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.

İlişkili Bağlantılar

• Sertifika Sağlayıcı Hakkında
• Sağlayıcılar_Hakkında
• Alıntı Yapma Kuralları Hakkında
• Kayıt Sağlayıcısı Hakkında
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path