Get-Item

Mendapatkan item di lokasi yang ditentukan.

Sintaks

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Stream <String[]>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-Stream <String[]>]
   [<CommonParameters>]

Deskripsi

Get-Item Cmdlet mendapatkan item di lokasi yang ditentukan. Ini tidak mendapatkan konten item di lokasi kecuali Anda menggunakan karakter kartubebas (*) untuk meminta semua konten item.

Cmdlet ini digunakan oleh penyedia PowerShell untuk menavigasi berbagai jenis penyimpanan data.

Contoh

Contoh 1: Dapatkan direktori saat ini

Contoh ini mendapatkan direktori saat ini. Titik ('.') mewakili item di lokasi saat ini (bukan isinya).

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Contoh 2: Dapatkan semua item di direktori saat ini

Contoh ini mendapatkan semua item di direktori saat ini. Karakter kartubebas (*) mewakili semua isi item saat ini.

Get-Item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

Contoh 3: Mendapatkan direktori drive saat ini

Contoh ini mendapatkan direktori C: drive saat ini. Objek yang diambil hanya mewakili direktori, bukan isinya.

Get-Item C:

Contoh 4: Mendapatkan item di drive yang ditentukan

Contoh ini mendapatkan item di C: drive. Karakter kartubebas (*) mewakili semua item dalam kontainer, bukan hanya kontainer.

Get-Item C:\*

Di PowerShell, gunakan tanda bintang tunggal (*) untuk mendapatkan konten, bukan tradisional *.*. Format ini ditafsirkan secara harfiah, jadi *.* tidak akan mengambil direktori atau nama file tanpa titik.

Contoh 5: Mendapatkan properti di direktori yang ditentukan

Contoh ini mendapatkan properti LastAccessTime dari C:\Windows direktori. LastAccessTime hanyalah satu properti direktori sistem file. Untuk melihat semua properti direktori, ketik (Get-Item <directory-name>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

Contoh 6: Menampilkan konten kunci registri

Contoh ini memperlihatkan konten kunci registri Microsoft.PowerShell . Anda dapat menggunakan cmdlet ini dengan penyedia PowerShell Registry untuk mendapatkan kunci registri dan subkunci, tetapi Anda harus menggunakan Get-ItemProperty cmdlet untuk mendapatkan nilai dan data registri.

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Contoh 7: Mendapatkan item dalam direktori yang memiliki pengecualian

Contoh ini mendapatkan item di direktori Windows dengan nama yang menyertakan titik (.), tetapi tidak dimulai dengan w*. Contoh ini hanya berfungsi ketika jalur menyertakan karakter kartubebas (*) untuk menentukan konten item.

Get-Item C:\Windows\*.* -Exclude "w*"

Di PowerShell 6.2, tampilan alternatif ditambahkan untuk mendapatkan informasi hardlink. Untuk mendapatkan informasi hardlink, pipa output ke Format-Table -View childrenWithHardlink

Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink

Directory: C:\Windows\System32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---           5/12/2021  7:40 AM       10848576 ntoskrnl.exe

Properti Mode mengidentifikasi hardlink dengan lla---

Contoh 9: Output untuk Sistem Operasi Non-Windows

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

PS> Get-Item /Users

Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

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 ditunjukkan pada sistem Unix

Catatan

Fitur ini dipindahkan dari eksperimental ke mainstream di PowerShell 7.1.

Parameter

-Credential

Catatan

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Menentukan, sebagai array string, item atau item yang dikecualikan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt. Karakter kartubebas diizinkan. Parameter Kecualikan hanya berlaku ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter kartubebas C:\Windows menentukan konten direktori.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Force

Menunjukkan bahwa cmdlet ini mendapatkan item yang tidak dapat diakses, seperti item tersembunyi. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat about_Providers. Bahkan menggunakan parameter Force , cmdlet tidak dapat mengambil alih pembatasan keamanan.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Menentukan, sebagai array string, item atau item yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . 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.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 menafsirkan karakter apa pun sebagai urutan escape.

Untuk informasi selengkapnya, lihat about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Menentukan jalur ke item. Cmdlet ini mendapatkan item di lokasi yang ditentukan. Karakter kartubebas diizinkan. Parameter ini diperlukan, tetapi nama parameter Jalur bersifat opsional.

Gunakan titik (.) untuk menentukan lokasi saat ini. Gunakan karakter kartubebas (*) untuk menentukan semua item di lokasi saat ini.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Stream

Catatan

Parameter ini hanya tersedia di Windows.

Mendapatkan aliran data alternatif yang ditentukan dari file. Masukkan nama aliran. Kartubebas didukung. Untuk mendapatkan semua aliran, gunakan tanda bintang (*). Parameter ini valid pada direktori, tetapi perhatikan bahwa direktori tidak memiliki aliran data secara default.

Parameter ini diperkenalkan di PowerShell 3.0. Pada PowerShell 7.2, Get-Item bisa mendapatkan aliran data alternatif dari direktori serta file.

Type:String[]
Position:Named
Default value:No alternate file streams
Accept pipeline input:False
Accept wildcard characters:True

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

Object

Cmdlet ini mengembalikan objek yang didapatkannya. Jenis ditentukan oleh jenis objek di jalur.

Catatan

Cmdlet ini tidak memiliki parameter Berulang , karena hanya mendapatkan item, bukan kontennya. Untuk mendapatkan konten item secara rekursif, gunakan Get-ChildItem.

Untuk menavigasi melalui registri, gunakan cmdlet ini untuk mendapatkan kunci registri dan Get-ItemProperty untuk mendapatkan nilai dan data registri. Nilai registri dianggap sebagai properti kunci registri.

Cmdlet ini 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.