Get-Item
Mendapatkan item di lokasi yang ditentukan.
Sintaks
Path (Default) - FileSystem provider
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
LiteralPath - FileSystem provider
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
Path (Default) - Certificate provider
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
LiteralPath - Certificate provider
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Path (Default) - All providers
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]
LiteralPath - All providers
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]
Deskripsi
cmdlet Get-Item mendapatkan item di lokasi yang ditentukan. Konten item di lokasi tidak akan diambil kecuali Anda menggunakan karakter wildcard (*) untuk meminta semua konten item.
Cmdlet ini digunakan oleh penyedia PowerShell untuk menavigasi melalui 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 mengambil semua item di direktori saat ini. Karakter wildcard (*) 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 saat ini dari drive C:. Objek yang diambil hanya mewakili direktori, bukan kontennya.
Get-Item C:
Contoh 4: Mendapatkan item di drive yang ditentukan
Contoh ini mengambil item di drive C:. Karakter wildcard (*) mewakili semua item dalam wadah, bukan hanya wadahnya.
Get-Item C:\*
Di PowerShell, gunakan tanda bintang tunggal (*) untuk mendapatkan konten, bukan *.*tradisional . Format 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 direktori C:\Windows.
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 cmdlet Get-ItemProperty untuk mendapatkan nilai dan data registri.
Get-Item HKLM:\Software\Microsoft\PowerShell\1\Shellids\Microsoft.PowerShell\
Contoh 7: Mendapatkan item di 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*"
Contoh 8: Mendapatkan informasi hardlink
Di PowerShell 6.2, tampilan alternatif ditambahkan untuk mendapatkan informasi hardlink. Untuk mendapatkan informasi hardlink, salurkan keluaran 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 menggunakan l di la---
Contoh 9: Output untuk Sistem Operasi Non-Windows
Di PowerShell 7.1 pada sistem Unix, cmdlet Get-Item 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
- 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.
Parameter
-CodeSigningCert
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
Untuk mendapatkan sertifikat yang memiliki Code Signing dalam nilai properti EnhancedKeyUsageList, gunakan parameter CodeSigningCert.
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Credential
Nota
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.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | Current user |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-DnsName
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
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
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | DnsNameRepresentation |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-DocumentEncryptionCert
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
Untuk mendapatkan sertifikat yang memiliki Document Encryption dalam nilai properti EnhancedKeyUsageList, gunakan parameter DocumentEncryptionCert.
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Eku
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
Menspesifikasikan teks atau pola teks untuk dicocokkan dengan properti EnhancedKeyUsageList dari sertifikat yang didapatkan cmdlet. Karakter pengganti (*) diizinkan. Properti EnhancedKeyUsageList berisi nama ramah pengguna dan bidang OID dari EKU.
Parameter ini diperkenalkan kembali di PowerShell 7.1
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Exclude
Menentukan item atau item-item yang tidak akan disertakan dalam operasi oleh cmdlet ini, dalam bentuk array string. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter pengganti diizinkan. Parameter Exclude hanya efektif ketika perintah menyertakan konten suatu item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ExpiringInDays
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
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
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Filter
Menentukan filter untuk mengkualifikasi 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 ?.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Force
Menunjukkan bahwa cmdlet ini mendapatkan item yang tidak dapat diakses dengan cara lain, seperti item tersembunyi. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat tentang_Penyedia. Bahkan menggunakan parameter Force, cmdlet tidak dapat mengabaikan pembatasan keamanan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Include
Menentukan item atau beberapa item dalam bentuk array string yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. 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.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-LiteralPath
Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika jalur menyertakan karakter escape, bungkus jalur tersebut dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Untuk informasi lebih lanjut, lihat about_Quoting_Rules.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | PSPath, LP |
Set parameter
LiteralPath
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan jalur ke item. Cmdlet ini mendapatkan item di lokasi yang ditentukan. Karakter pengganti diizinkan. Parameter ini diperlukan, tetapi nama parameter Jalur bersifat opsional.
Gunakan titik (.) untuk menentukan lokasi saat ini. Gunakan karakter pengganti (*) untuk menentukan semua item di lokasi sekarang.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
Path
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-SSLServerAuthentication
Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat. Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.
Untuk mendapatkan sertifikat yang memiliki Server Authentication dalam nilai properti EnhancedKeyUsageList, gunakan parameter SSLServerAuthentication.
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Stream
Ini adalah parameter dinamis yang disediakan oleh penyedia FileSystem. Parameter ini hanya tersedia di Windows.
Mendapatkan aliran data alternatif yang ditentukan dari file. Masukkan nama aliran. Penggunaan wildcard 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.
Untuk informasi selengkapnya, lihat about_FileSystem_Provider.
Properti parameter
| Jenis: | String[] |
| Nilai default: | No alternate file streams |
| Mendukung wildcard: | True |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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:.
Catatan
PowerShell menyertakan alias berikut untuk Get-Item:
- Semua platform:
gi
Cmdlet ini tidak memiliki parameter Recurse, karena hanya mendapatkan item, bukan isinya.
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 dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.
