Get-ChildItem

Başvuru

Modül:: Microsoft.PowerShell.Management

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 belirtilen bir veya daha fazla konumdaki öğeleri 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 Recurse parametresini 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'iGet-ChildItem, dizinini C:\Testbelirtmek 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ı listelenir.

cmdlet'iGet-ChildItem, dizinini C:\Testbelirtmek 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 dizinde ve alt dizinlerde alt öğeleri alma

Bu örnekte, geçerli dizinde ve alt dizinlerinde bulunan dosyalar görüntülenir .txt .

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

cmdlet'i Get-ChildItem belirtmek C:\Test\*.txtiçin Path parametresini kullanır. Yol, dosya adı uzantısına .txtsahip 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 dizinlerini arar. 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'iGet-ChildItem, dizinini C:\Testbelirtmek 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 .txtsahip tüm dosyaları belirtmek için 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şaretine (*) sahip olması 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\Logsiç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'iGet-ChildItem, dizinini C:\Test\Logsbelirtmek için Path parametresini kullanır. Exclude parametresi, çıkışla A başlayan veya çıkıştan dışlanan tüm dosyaları veya a dizinleri belirtmek için yıldız (*) joker karakterini kullanır.

Exclude parametresi kullanıldığında, Path parametresindeki sondaki yıldız işareti (*) isteğe bağlıdır. Örneğin, -Path C:\Test\Logs veya -Path C:\Test\Logs\*.

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 komutuna eklenirse, Path parametresi sondaki yıldız işareti (* )'ni içerse de içermese de özyineleme çıkışı aynıdır.

Örnek 6: Kayıt defteri anahtarlarını bir kayıt defteri kovanından alma

Bu örnek, 'den HKEY_LOCAL_MACHINE\HARDWAREtüm kayıt defteri anahtarlarını alır.

Get-ChildItem, kayıt defteri anahtarını HKLM:\HARDWAREbelirtmek için Path parametresini kullanır. PowerShell konsolunda, kovanın yolu ve en üst düzey kayıt defteri anahtarları 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ürmemenizi söylerGet-ChildItem. Ş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.

Cmdlet, 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 aramalar. 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 özyinelemeye eklenecek 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:\Parentiçin Path parametresini kullanır. Depth parametresi iki özyineleme düzeyini belirtir. Get-ChildItemPath 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 temsil edilen 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 temele taşındı.

Örnek 11: Birleşim 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 Get-ChildItem döndürülen 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-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 yeniden ayrıştırma noktası için hedef bilgileri almak için bir yol sağlamaz. Dosya sistemi nesnesinin LinkTarget ve LinkType özellikleri boş.

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 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 Öznitelikler 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
Yeniden Ayrıştırma Noktası
SparseFile
Sistem
Geçici

Bu özniteliklerin açıklaması için bkz . FileAttributes Numaralandırması.

Ö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)

Type:	FlagsExpression<T>[FileAttributes]
Accepted values:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Depth

Bu parametre PowerShell 5.0'a eklendi ve özyineleme derinliğini denetlemenizi sağlar. 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ı çıktıya eklenir.

Not

PowerShell'den veya cmd.exe bir 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
Required:	False
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 parametresini veya Directory özelliğiyle Attributes parametresini kullanın. Recurse parametresini Directory ile kullanabilirsiniz.

Type:	SwitchParameter
Aliases:	ad
Position:	Named
Default value:	None
Required:	False
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 ASCIIolabilirUnicode. 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
Required:	False
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 Document Encryptionsertifikaların listesini almak için DocumentEncryptionCert parametresini kullanın.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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 *.txtA*bir yol öğesi veya deseni girin. Joker karakterler kabul edilir.

Path 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 yinelenir. 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.

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
Required:	False
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 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ı

Type:	Int32
Position:	Named
Default value:	None
Required:	False
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 Recurse parametresini kullanabilirsiniz.

Type:	SwitchParameter
Aliases:	af
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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 bunları yinelemez. 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Cmdlet'in gizli 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
Required:	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 Hidden özelliğiyle Attributes parametresini kullanın. Varsayılan olarak gizli Get-ChildItem öğeleri görüntülemez. Gizli öğeleri almak için Force parametresini kullanın.

Type:	SwitchParameter
Aliases:	ah, h
Position:	Named
Default value:	None
Required:	False
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 komutu 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
Required:	False
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 yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz . about_Quoting_Rules.

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
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
Required:	False
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
Required:	False
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
Required:	False
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
Required:	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ğerindeki Server Authenticationsertifikaların listesini almak için SSLServerAuthentication parametresini kullanın.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

String

Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

AliasInfo

Cmdlet, sürücüye erişirken bu tür çıkışlar Alias: oluşturur.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet, sürücüye erişirken bu türlerin çıkışını Cert: oluşturur.

DictionaryEntry

Cmdlet, sürücüye erişirken bu tür çıkışlar Env: oluşturur.

DirectoryInfo

FileInfo

Cmdlet, Dosya Sistemi sürücülerine erişirken bu türlerin çıkışını oluşturur.

FunctionInfo

FilterInfo

Cmdlet, sürücülere erişirken bu türlerin çıkışını Function: oluşturur.

RegistryKey

Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür bir çıkış oluşturur.

PSVariable

Cmdlet, sürücülere erişirken Variable: bu tür çıkış yapar.

WSManConfigContainerElement

WSManConfigLeafElement

Cmdlet, sürücülere erişirken bu türlerin çıkışını WSMan: oluşturur.

String

Name parametresini kullandığınızda, bu cmdlet nesne adlarını dize olarak döndürür.

Notlar

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

Tüm platformlar:
- dir, gci
Windows:
- ls

Get-ChildItem varsayılan olarak gizli öğeleri almaz. Gizli öğeleri almak için Zorla 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.

Get-ChildItem

Syntax

Description

Örnekler

Örnek 1: Dosya sistemi dizininden alt öğeleri alma

Örnek 2: Dizinde alt öğe adlarını alma

Örnek 3: Geçerli dizinde ve alt dizinlerde alt öğeleri alma

Örnek 4: Include parametresini kullanarak alt öğeleri alma

Örnek 5: Exclude parametresini kullanarak alt öğeleri alma

Örnek 6: Kayıt defteri anahtarlarını bir kayıt defteri kovanından alma

Örnek 7: Kod imzalama yetkilisiyle tüm sertifikaları alma

Örnek 8: Depth parametresini kullanarak öğeleri alma

Örnek 9: Sabit bağlantı bilgilerini alma

Örnek 10: Windows Dışı İşletim Sistemleri için Çıkış

Örnek 11: Birleşim noktası için bağlantı hedefini alma

Örnek 12: AppX yeniden ayrıştırma noktası için bağlantı hedefini alma

Parametreler

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar