Get-ChildItem

Sözdizimi

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 Yol dizininde ve onun alt dizinlerinde arama yapın. 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

Ö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

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

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.

İlişkili Bağlantılar

• about_Certificate_Provider
• about_Providers
• about_Quoting_Rules
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path