Bagikan melalui

Get-ChildItem

  • Referensi
Modul:
Microsoft.PowerShell.Management

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

Deskripsi

cmdlet Get-ChildItem mengambil item di satu atau beberapa lokasi yang ditentukan. Jika item adalah kontainer, item tersebut mendapatkan item-item di dalam kontainer, yang dikenal sebagai item anak. Anda dapat menggunakan parameter Recurse untuk mendapatkan item di semua kontainer turunan dan menggunakan parameter Depth untuk membatasi jumlah tingkat rekursi.

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

Cmdlet Get-ChildItem dirancang untuk bekerja dengan item yang diekspos oleh penyedia mana pun. Misalnya, item dapat berupa file atau direktori sistem file, sarang registri, atau penyimpanan sertifikat. Untuk mencantumkan penyedia yang tersedia di sesi Anda, gunakan perintah Get-PSProvider. Beberapa parameter hanya tersedia untuk penyedia tertentu. Untuk informasi selengkapnya, lihat tentang_Penyedia.

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.

Cmdlet Get-ChildItem 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.

Cmdlet Get-ChildItem 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 file .txt 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

Cmdlet Get-ChildItem menggunakan parameter Jalur untuk menentukan C:\Test\*.txt. Path menggunakan wildcard tanda bintang (*) untuk menentukan semua file dengan ekstensi nama file .txt. Parameter Recurse mencari direktori Jalur dan subdirektori, seperti yang ditunjukkan di judul Direktori:. Parameter Force menampilkan file tersembunyi seperti hiddenfile.txt yang memiliki mode h.

Contoh 4: Dapatkan item anak menggunakan parameter Sertakan

Dalam contoh ini Get-ChildItem 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

Cmdlet Get-ChildItem menggunakan parameter Jalur untuk menentukan direktori C:\Test. Parameter Jalur menyertakan karakter pengganti tanda bintang (*) untuk menentukan isi direktori. Parameter Sertakan menggunakan wildcard tanda bintang (*) untuk menentukan semua file dengan ekstensi nama file .txt.

Saat parameter Sertakan digunakan, parameter Jalur memerlukan pola pengganti tanda bintang di akhir (*) untuk menentukan isi direktori. Misalnya, -Path C:\Test\*.

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

Contoh 5: Mengambil item anak menggunakan parameter mengecualikan

Output dari contoh tersebut menunjukkan isi dari 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

Cmdlet Get-ChildItem menggunakan parameter Jalur untuk menentukan direktori C:\Test\Logs. Parameter Exclude menggunakan wildcard tanda bintang (*) untuk menentukan file atau direktori apa pun yang dimulai dengan A atau a dikecualikan dari output.

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

  • Jika tanda bintang terakhir (*) tidak disertakan dalam parameter Jalur, konten parameter Jalur ditampilkan. Pengecualiannya adalah nama file atau nama subdirektori yang cocok dengan nilai parameter Kecualikan.
  • Jika tanda bintang terakhir (*) disertakan dalam parameter Jalur , perintah akan menelusuri subdirektori dari parameter Jalur . Pengecualiannya adalah nama file atau nama subdirektori yang cocok dengan nilai parameter Kecualikan.
  • Jika parameter Recurse ditambahkan ke perintah, output rekursi sama, terlepas dari apakah parameter Jalur menyertakan tanda asterisk di akhir (*).

Contoh 6: Mendapatkan kunci registri dari sarang registri

Contoh ini mendapatkan semua kunci registri dari HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem menggunakan parameter Jalur untuk menentukan kunci registri HKLM:\HARDWARE. Jalur dan tingkat teratas 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 Exclude memberi tahu Get-ChildItem untuk tidak mengembalikan subkunci apa pun yang dimulai dengan D*. Saat ini, parameter Exclude hanya berfungsi pada subkunci, bukan properti item.

Contoh 7: Mendapatkan semua sertifikat dengan otoritas penandatanganan kode

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

Cmdlet Get-ChildItem menggunakan parameter Jalur untuk menentukan Penyedia sertifikat dengan drive Cert:. 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 drive Cert:, 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

Cmdlet Get-ChildItem 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

Pada 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
  • User adalah pemilik file
  • Group adalah pemilik grup
  • Ukuran adalah ukuran file atau direktori seperti yang diwakili pada sistem Unix

Nota

Fitur ini dipindahkan dari eksperimental ke mainstream di PowerShell 7.1.

Contoh 11: Dapatkan target tautan untuk titik persimpangan

Perintah dir di Windows Command Shell menunjukkan lokasi target titik persimpangan sistem file. Di PowerShell, informasi ini tersedia dari properti LinkTarget 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 reanalisis AppX

Contoh ini mencoba mendapatkan informasi target untuk titik pemisahan ulang AppX. Aplikasi Microsoft Store membuat poin pemrosesan 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 objek sistem file kosong.

Parameter

-Attributes

Nota

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 Directory, File, Tersembunyi, ReadOnly, dan System.

Parameter Atribut mendukung nilai berikut:

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

Untuk deskripsi atribut ini, lihat enumerasi FileAttributes.

Untuk menggabungkan atribut, gunakan operator berikut:

  • ! (TIDAK)
  • + (AND)
  • , (OR)

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

Nota

Parameter ini hanya tersedia di penyedia Sertifikat.

Untuk mendapatkan daftar sertifikat yang memiliki Code Signing dalam 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 menyertakan direktori parameter Path, subdirektori tingkat pertama, dan subdirektori tingkat kedua. Secara default, nama direktori dan nama file disertakan dalam output.

Nota

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

Nota

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 Directory.

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

-DnsName

Nota

Parameter ini hanya tersedia di penyedia Sertifikat.

Menentukan nama domain atau pola nama yang cocok dengan properti DNSNameList dari sertifikat yang diperoleh oleh cmdlet. Nilai parameter ini dapat Unicode atau ASCII. Nilai punycode dikonversi ke Unicode. Karakter pengganti (*) 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

Nota

Parameter ini hanya tersedia di penyedia Sertifikat.

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

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

-Eku

Nota

Parameter ini hanya tersedia di penyedia Sertifikat.

Menentukan teks atau pola teks yang harus cocok dengan properti EnhancedKeyUsageList dari sertifikat yang didapatkan oleh cmdlet. Karakter pengganti (*) 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 hasil. Masukkan elemen atau pola jalur, seperti *.txt atau A*. Karakter wildcard diterima.

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

Parameter Sertakan dan Kecualikan bisa digunakan secara bersamaan. 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

Nota

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

Nota

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 menentukan kualifikasi 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 wildcard * dan ?.

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

-FollowSymlink

Nota

Parameter ini hanya tersedia di penyedia FileSystem.

Secara default, cmdlet Get-ChildItem 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 mengakses item yang biasanya tidak dapat diakses oleh pengguna, seperti file tersembunyi atau sistem. Parameter Force tidak mengesampingkan pembatasan keamanan. Implementasi bervariasi menurut penyedia. Untuk informasi selengkapnya, lihat tentang_Penyedia.

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

-Hidden

Nota

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 Force 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 pengganti diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

Parameter Sertakan dan Kecualikan bisa digunakan secara bersamaan. 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 ditulis. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, bungkus dengan 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 memperoleh nama item di lokasi. Output adalah objek string yang dapat dikirim melalui alur kerja 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. Jika tidak ditentukan, lokasi default adalah direktori saat ini (.). Karakter pengganti diterima. Gunakan perawatan saat menggunakan parameter Jalur dengan parameter Berulang. Untuk informasi selengkapnya, lihat bagian NOTES di artikel ini.

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

-ReadOnly

Nota

Parameter ini hanya tersedia di penyedia FileSystem.

Untuk mendapatkan item yang hanya dapat dibaca, gunakan parameter ReadOnly atau parameter Atribut dengan properti ReadOnly.

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, r
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SSLServerAuthentication

Nota

Parameter ini hanya tersedia di penyedia Sertifikat.

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

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

-System

Nota

Parameter ini hanya tersedia di penyedia FileSystem.

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

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 drive Alias:.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet menghasilkan jenis ini saat mengakses drive Cert:.

DictionaryEntry

Cmdlet menghasilkan jenis ini saat mengakses drive Env:.

DirectoryInfo

FileInfo

Cmdlet menghasilkan jenis ini saat mengakses drive FileSystem.

FunctionInfo

FilterInfo

Cmdlet menghasilkan jenis ini saat mengakses drive Function:.

RegistryKey

Cmdlet menghasilkan jenis ini saat mengakses drive Registri.

PSVariable

Cmdlet menghasilkan jenis ini saat mengakses drive Variable:.

WSManConfigContainerElement

WSManConfigLeafElement

Cmdlet menghasilkan jenis ini saat mengakses drive WSMan:.

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

Perilaku rekursi dengan parameter Jalur:

Saat Anda menggunakan Get-ChildItem -Recurse dengan parameter Jalur, cmdlet mencari komponen jalur terakhir apakah itu pola kartubebas atau nama harfiah atau tidak.

  • Jika komponen jalur terakhir cocok dengan subdirektori langsung direktori target yang ada, cmdlet melakukan enumerasi rekursif pada direktori yang cocok.
  • Jika komponen jalur terakhir tidak cocok dengan subdirektori langsung direktori target yang ada, cmdlet secara rekursif mencari hierarki direktori target untuk item yang cocok dengan komponen jalur terakhir

Saat Anda menggunakan Get-ChildItem -Recurse dengan parameter Path dan Name, perilaku berubah. Perintah mencari komponen jalur terakhir di antara item turunan langsung dari direktori target.

  • Jika ada kecocokan di antara item turunan langsung, cmdlet melakukan enumerasi rekursif pada item yang cocok. Pencocokan kartubebas hanya terjadi sekali, di tingkat atas direktori target. Hasilnya diproses seolah-olah mereka telah diteruskan secara individual ke parameter LiteralPath.
  • Jika komponen jalur terakhir tidak cocok dengan item apa pun di tingkat atas, kesalahan terjadi.

Anda harus menghindari penggunaan parameter Jalur dengan parameter Berulang. Untuk hasil terbaik:

  • Gunakan LiteralPath untuk menentukan direktori target untuk menghindari pemicu pencarian rekursif untuk komponen jalur terakhir.
  • Gunakan Filter atau Sertakan parameter untuk menentukan pola kartubebas atau literal yang harus dicari di setiap tingkat hierarki direktori target.