Bagikan melalui


Get-ChildItem

Mendapatkan item dan item turunan di satu atau beberapa lokasi yang ditentukan.

Sintaks

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>]

Deskripsi

Get-ChildItem Cmdlet mendapatkan item di satu atau beberapa lokasi yang ditentukan. Jika item adalah kontainer, item tersebut akan berada di dalam kontainer, yang dikenal sebagai item turunan. Anda dapat menggunakan parameter Recurse untuk mendapatkan item di semua kontainer turunan dan menggunakan parameter Kedalaman untuk membatasi jumlah tingkat untuk berulang.

Get-ChildItem tidak menampilkan direktori kosong. Get-ChildItem Saat perintah menyertakan parameter Kedalaman atau Berulang, direktori kosong tidak disertakan dalam output.

Lokasi diekspos Get-ChildItem oleh penyedia PowerShell. Lokasi dapat berupa direktori sistem file, sarang registri, atau penyimpanan sertifikat. Beberapa parameter hanya tersedia untuk penyedia tertentu. Untuk informasi selengkapnya, lihat about_Providers.

Contoh

Contoh 1: Mendapatkan item anak dari direktori sistem file

Contoh ini mendapatkan item anak dari direktori sistem file. Nama file dan nama subdirektori ditampilkan. Untuk lokasi kosong, perintah tidak mengembalikan output apa pun dan kembali ke prompt PowerShell.

Get-ChildItem Cmdlet menggunakan parameter Jalur untuk menentukan direktori C:\Test. Get-ChildItem menampilkan file dan direktori di konsol PowerShell.

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

Secara default Get-ChildItem mencantumkan mode (Atribut), LastWriteTime, ukuran file (Panjang), dan Nama item. Huruf dalam properti Mode dapat ditafsirkan sebagai berikut:

  • l (tautan)
  • d (direktori)
  • a (arsip)
  • r (baca-saja)
  • h (tersembunyi)
  • s (sistem)

Untuk informasi selengkapnya tentang bendera mode, lihat about_Filesystem_Provider.

Contoh 2: Mendapatkan nama item anak dalam direktori

Contoh ini hanya mencantumkan nama item dalam direktori.

Get-ChildItem Cmdlet menggunakan parameter Jalur untuk menentukan direktori C:\Test. Parameter Nama hanya mengembalikan nama file atau direktori dari jalur yang ditentukan. Nama yang dikembalikan relatif terhadap nilai parameter Jalur .

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

Contoh 3: Mendapatkan item anak di direktori dan subdirektori saat ini

Contoh ini menampilkan .txt file yang terletak di direktori saat ini dan subdirektorinya.

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 menggunakan parameter Jalur untuk menentukan C:\Test\*.txt. Jalur menggunakan kartubebas tanda bintang (*) untuk menentukan semua file dengan ekstensi .txtnama file . Parameter Recurse mencari direktori Jalur dan subdirektorinya, seperti yang ditunjukkan dalam judul Direktori: . Parameter Paksa menampilkan file tersembunyi seperti hiddenfile.txt yang memiliki mode h.

Contoh 4: Dapatkan item anak menggunakan parameter Sertakan

Dalam contoh Get-ChildItem ini menggunakan parameter Sertakan untuk menemukan item tertentu dari direktori yang ditentukan oleh parameter Jalur .

# 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 menggunakan parameter Jalur untuk menentukan direktori C:\Test. Parameter Jalur menyertakan kartubebas tanda bintang (*) berikutnya untuk menentukan konten direktori. Parameter Sertakan menggunakan kartubebas tanda bintang (*) untuk menentukan semua file dengan ekstensi .txtnama file .

Saat parameter Sertakan digunakan, parameter Jalur memerlukan kartubebas tanda bintang (*) berikutnya untuk menentukan konten direktori. Contohnya,-Path C:\Test\*.

  • Jika parameter Berulang ditambahkan ke perintah, tanda bintang berikutnya (*) di parameter Jalur bersifat opsional. Parameter Recurse mendapatkan item dari direktori Jalur dan subdirektorinya. Misalnya: -Path C:\Test\ -Recurse -Include *.txt
  • Jika tanda bintang berikutnya (*) tidak disertakan dalam parameter Jalur , perintah tidak mengembalikan output apa pun dan kembali ke prompt PowerShell. Contohnya,-Path C:\Test\.

Contoh 5: Dapatkan item turunan menggunakan parameter Kecualikan

Output contoh menunjukkan konten direktori C:\Test\Logs. Output adalah referensi untuk perintah lain yang menggunakan parameter Kecualikan dan Berulang .

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 menggunakan parameter Jalur untuk menentukan direktori C:\Test\Logs. Parameter Kecualikan menggunakan kartubebas tanda bintang (*) untuk menentukan file atau direktori apa pun yang dimulai dengan A atau a dikecualikan dari output.

Saat parameter Kecualikan digunakan, tanda bintang berikutnya (*) di parameter Jalur bersifat opsional. Misalnya, -Path C:\Test\Logs atau -Path C:\Test\Logs\*.

  • Jika tanda bintang berikutnya (*) tidak disertakan dalam parameter Jalur , konten parameter Jalur ditampilkan. Pengecualian adalah nama file atau nama subdirektori yang cocok dengan nilai parameter Kecualikan .
  • Jika tanda bintang berikutnya (*) disertakan dalam parameter Jalur , perintah akan berulang ke subdirektori parameter Jalur . Pengecualian adalah nama file atau nama subdirektori yang cocok dengan nilai parameter Kecualikan .
  • Jika parameter Recurse ditambahkan ke perintah, output rekursi sama apakah parameter Path menyertakan tanda bintang berikutnya (*).

Contoh 6: Mendapatkan kunci registri dari sarang registri

Contoh ini mendapatkan semua kunci registri dari HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItemmenggunakan parameter Jalur untuk menentukan kunci HKLM:\HARDWAREregistri . Jalur apache hive dan tingkat atas kunci registri ditampilkan di konsol PowerShell.

Untuk informasi selengkapnya, lihat 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

Perintah pertama menunjukkan konten kunci registri HKLM:\HARDWARE . Parameter Kecualikan memberi tahu Get-ChildItem untuk tidak mengembalikan subkunci apa pun yang dimulai dengan D*. Saat ini, parameter Kecualikan hanya berfungsi pada subkunci, bukan properti item.

Contoh 7: Mendapatkan semua sertifikat dengan otoritas penandatanganan kode

Contoh ini mendapatkan setiap sertifikat di drive PowerShell Cert: yang memiliki otoritas penandatanganan kode.

Get-ChildItem Cmdlet menggunakan parameter Jalur untuk menentukan Penyedia sertifikat dengan Cert: drive. Parameter Recurse mencari direktori yang ditentukan oleh Path dan subdirektorinya. Parameter CodeSigningCert hanya mendapatkan sertifikat yang memiliki otoritas penandatanganan kode.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

Untuk informasi selengkapnya tentang Penyedia sertifikat dan Cert: drive, lihat about_Certificate_Provider.

Contoh 8: Dapatkan item menggunakan parameter Kedalaman

Contoh ini menampilkan item dalam direktori dan subdirektorinya. Parameter Kedalaman menentukan jumlah tingkat subdirektori yang akan disertakan dalam rekursi. Direktori kosong dikecualikan dari output.

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 menggunakan parameter Jalur untuk menentukan C:\Parent. Parameter Kedalaman menentukan dua tingkat rekursi. Get-ChildItem menampilkan konten direktori yang ditentukan oleh parameter Jalur dan dua tingkat subdirektori.

Contoh 9: Mendapatkan informasi tautan keras

Di PowerShell 6.2, tampilan alternatif ditambahkan untuk mendapatkan informasi tautan keras.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

Contoh 10: Output untuk Sistem Operasi Non-Windows

Di PowerShell 7.1 pada sistem Unix, Get-ChildItem menyediakan output seperti Unix:

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

Properti baru yang sekarang menjadi bagian dari output adalah:

  • UnixMode adalah izin file seperti yang diwakili pada sistem Unix
  • Pengguna adalah pemilik file
  • Grup adalah pemilik grup
  • Ukuran adalah ukuran file atau direktori seperti yang diwakili pada sistem Unix

Catatan

Fitur ini dipindahkan dari eksperimental ke mainstream di PowerShell 7.1.

Contoh 11: Dapatkan target tautan untuk titik persimpangan

dir Perintah di Windows Command Shell menunjukkan lokasi target titik persimpangan sistem file. Di PowerShell, informasi ini tersedia dari properti LinkTarget dari objek sistem file yang dikembalikan oleh Get-ChildItem dan ditampilkan dalam output default.

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

Contoh 12: Dapatkan target tautan untuk titik pemisahan ulang AppX

Contoh ini mencoba mendapatkan informasi target untuk titik pemisahan ulang AppX. Aplikasi Microsoft Store membuat titik pemisahan ulang AppX di direktori AppData pengguna.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

Saat ini, Windows tidak menyediakan cara untuk mendapatkan informasi target untuk titik pemisahan ulang AppX. Properti LinkTarget dan LinkType dari objek filesystem kosong.

Parameter

-Attributes

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Mendapatkan file dan folder dengan atribut yang ditentukan. Parameter ini mendukung semua atribut dan memungkinkan Anda menentukan kombinasi atribut yang kompleks.

Misalnya, untuk mendapatkan file non-sistem (bukan direktori) yang dienkripsi atau dikompresi, ketik:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Untuk menemukan file dan folder dengan atribut yang umum digunakan, gunakan parameter Atribut . Atau, parameter Direktori, File, Tersembunyi, ReadOnly, dan Sistem.

Parameter Atribut mendukung properti berikut:

  • Mengarsipkan
  • Dikompresi
  • Perangkat
  • Direktori
  • Dienkripsi
  • Tersembunyi
  • IntegrityStream
  • Normal
  • NoScrubData
  • NotContentIndexed
  • Luring
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • Log
  • Sementara

Untuk deskripsi atribut ini, lihat Enumerasi FileAttributes.

Untuk menggabungkan atribut, gunakan operator berikut:

  • ! (TIDAK)
  • + (DAN)
  • , (ATAU)

Jangan gunakan spasi antara operator dan atributnya. Spasi diterima setelah koma.

Untuk atribut umum, gunakan singkatan berikut:

  • D (Direktori)
  • H (Tersembunyi)
  • R (Baca-saja)
  • S (Sistem)
Jenis:FlagsExpression<T>[FileAttributes]
Nilai yang diterima:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CodeSigningCert

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Untuk mendapatkan daftar sertifikat yang memiliki Code Signing nilai properti EnhancedKeyUsageList , gunakan parameter CodeSigningCert .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Depth

Parameter ini ditambahkan di PowerShell 5.0 dan memungkinkan Anda mengontrol kedalaman rekursi. Secara default, Get-ChildItem menampilkan konten direktori induk. Parameter Kedalaman menentukan jumlah tingkat subdirektori yang disertakan dalam rekursi dan menampilkan konten.

Misalnya, -Depth 2 mencakup direktori parameter Jalur , tingkat subdirektori pertama, dan tingkat subdirektori kedua. Secara default, nama direktori dan nama file disertakan dalam output.

Catatan

Di komputer Windows dari PowerShell atau cmd.exe, Anda bisa menampilkan tampilan grafis struktur direktori dengan perintah tree.com .

Jenis:UInt32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Directory

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Untuk mendapatkan daftar direktori, gunakan parameter Direktori atau parameter Atribut dengan properti Direktori . Anda dapat menggunakan parameter Recurse dengan Direktori.

Jenis:SwitchParameter
Alias:ad
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DnsName

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Menentukan nama domain atau pola nama yang cocok dengan properti DNSNameList sertifikat yang didapat cmdlet. Nilai parameter ini dapat berupa Unicode atau ASCII. Nilai punycode dikonversi ke Unicode. Karakter kartubebas (*) diizinkan.

Parameter ini diperkenalkan kembali di PowerShell 7.1

Jenis:DnsNameRepresentation
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-DocumentEncryptionCert

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Untuk mendapatkan daftar sertifikat yang memiliki Document Encryption nilai properti EnhancedKeyUsageList, gunakan parameter DocumentEncryptionCert.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Eku

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Menentukan teks atau pola teks yang cocok dengan properti EnhancedKeyUsageList sertifikat yang didapat cmdlet. Karakter kartubebas (*) diizinkan. Properti EnhancedKeyUsageList berisi nama yang mudah diingat dan bidang OID EKU.

Parameter ini diperkenalkan kembali di PowerShell 7.1

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-Exclude

Menentukan array dari satu atau beberapa pola string yang akan dicocokkan saat cmdlet mendapatkan item turunan. Item yang cocok dikecualikan dari output. Masukkan elemen atau pola jalur, seperti *.txt atau A*. Karakter kartubebas diterima.

Tanda bintang berikutnya (*) dalam parameter Jalur bersifat opsional. Misalnya, -Path C:\Test\Logs atau -Path C:\Test\Logs\*. Jika tanda bintang berikutnya (*) disertakan, perintah akan berulang ke subdirektori parameter Jalur . Tanpa tanda bintang (*), konten parameter Jalur ditampilkan. Detail selengkapnya disertakan di Contoh 5 dan bagian Catatan.

Parameter Sertakan dan Kecualikan dapat digunakan bersama-sama. Namun, pengecualian diterapkan setelah penyertaan, yang dapat memengaruhi output akhir.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-ExpiringInDays

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Menentukan bahwa cmdlet hanya boleh mengembalikan sertifikat yang kedaluwarsa di atau sebelum jumlah hari yang ditentukan. Nilai nol (0) mendapatkan sertifikat yang telah kedaluwarsa.

Parameter ini diperkenalkan kembali di PowerShell 7.1

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-File

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Untuk mendapatkan daftar file, gunakan parameter File . Anda dapat menggunakan parameter Recurse dengan File.

Jenis:SwitchParameter
Alias:af
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Filter

Menentukan filter untuk memenuhi syarat parameter Jalur . Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung filter. Filter lebih efisien daripada parameter lainnya. Penyedia menerapkan filter saat cmdlet mendapatkan objek daripada meminta PowerShell memfilter objek setelah diambil. String filter diteruskan ke .NET API untuk menghitung file. API hanya mendukung * dan ? kartubebas.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Secara default, Get-ChildItem cmdlet menampilkan tautan simbolis ke direktori yang ditemukan selama rekursi, tetapi tidak berulang ke dalamnya. Gunakan parameter FollowSymlink untuk mencari direktori yang menargetkan tautan simbolis tersebut. FollowSymlink adalah parameter dinamis dan hanya didukung di penyedia FileSystem.

Parameter ini diperkenalkan di PowerShell 6.0.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

Memungkinkan cmdlet untuk mendapatkan item yang sebaliknya tidak dapat diakses oleh pengguna, seperti file tersembunyi atau sistem. Parameter Force tidak mengambil alih pembatasan keamanan. Implementasi bervariasi di antara penyedia. Untuk informasi selengkapnya, lihat about_Providers.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Hidden

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Untuk mendapatkan hanya item tersembunyi, gunakan parameter Tersembunyi atau parameter Atribut dengan properti Tersembunyi . Secara default, Get-ChildItem tidak menampilkan item tersembunyi. Gunakan parameter Paksa untuk mendapatkan item tersembunyi.

Jenis:SwitchParameter
Alias:ah, h
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Include

Menentukan array dari satu atau beberapa pola string yang akan dicocokkan saat cmdlet mendapatkan item turunan. Item yang cocok disertakan dalam output. Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter kartubebas C:\Windows menentukan konten direktori.

Parameter Sertakan dan Kecualikan dapat digunakan bersama-sama. Namun, pengecualian diterapkan setelah penyertaan, yang dapat memengaruhi output akhir.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-LiteralPath

Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Untuk informasi selengkapnya, lihat about_Quoting_Rules.

Jenis:String[]
Alias:PSPath, LP
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Hanya mendapatkan nama item di lokasi. Output adalah objek string yang dapat dikirim ke alur ke perintah lain. Nama yang dikembalikan relatif terhadap nilai parameter Jalur .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur ke satu atau beberapa lokasi. Kartubebas diterima. Lokasi default adalah direktori saat ini (.).

Jenis:String[]
Position:0
Nilai default:Current directory
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:True

-ReadOnly

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Untuk mendapatkan hanya item baca-saja, gunakan parameter ReadOnly atau properti ReadOnly parameter Atribut.

Jenis:SwitchParameter
Alias:ar
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Recurse

Mendapatkan item di lokasi yang ditentukan dan di semua item turunan lokasi.

Jenis:SwitchParameter
Alias:s
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SSLServerAuthentication

Catatan

Parameter ini hanya tersedia di penyedia Sertifikat .

Untuk mendapatkan daftar sertifikat yang memiliki Server Authentication nilai properti EnhancedKeyUsageList, gunakan parameter SSLServerAuthentication.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-System

Catatan

Parameter ini hanya tersedia di penyedia FileSystem .

Hanya mendapatkan file dan direktori sistem. Untuk mendapatkan hanya file dan folder sistem, gunakan parameter Sistem atau properti Sistem parameter Atribut.

Jenis:SwitchParameter
Alias:as
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

AliasInfo

Cmdlet menghasilkan jenis ini saat mengakses Alias: drive.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet menghasilkan jenis ini saat mengakses Cert: drive.

DictionaryEntry

Cmdlet menghasilkan jenis ini saat mengakses Env: drive.

DirectoryInfo

FileInfo

Cmdlet menghasilkan jenis ini saat mengakses drive Filesystem.

FunctionInfo

FilterInfo

Cmdlet menghasilkan jenis ini saat mengakses Function: drive.

RegistryKey

Cmdlet menghasilkan jenis ini saat mengakses drive Registri.

PSVariable

Cmdlet menghasilkan jenis ini saat mengakses Variable: drive.

WSManConfigContainerElement

WSManConfigLeafElement

Cmdlet menghasilkan jenis ini saat mengakses WSMan: drive.

String

Saat Anda menggunakan parameter Nama , cmdlet ini mengembalikan nama objek sebagai string.

Catatan

PowerShell menyertakan alias berikut untuk Get-ChildItem:

  • Semua platform:
    • dir, gci
  • Windows:
    • ls

Get-ChildItem tidak mendapatkan item tersembunyi secara default. Untuk mendapatkan item tersembunyi, gunakan parameter Paksa .

Get-ChildItem Cmdlet dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.