Get-Item

Modul:

Microsoft.PowerShell.Management

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

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<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 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 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 kontennya.

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 Registri PowerShell 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 di direktori yang memiliki pengecualian

Contoh ini mendapatkan item di direktori Windows dengan nama yang menyertakan titik (.), tetapi jangan mulai 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, 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 diwakili pada sistem Unix

Catatan

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 nilai properti EnhancedKeyUsageList , gunakan parameter CodeSigningCert .

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

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

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

Jenis:	PSCredential
Position:	Named
Nilai default:	Current user
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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 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

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

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

-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 nilai properti EnhancedKeyUsageList , gunakan parameter DocumentEncryptionCert .

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

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

-Eku

Ini adalah parameter dinamis yang disediakan oleh penyedia Sertifikat . Parameter ini dan penyedia Sertifikat hanya tersedia di Windows.

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

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

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

-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 efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter kartubebas C:\Windows menentukan konten direktori.

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

-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 selengkapnya, lihat about_Certificate_Provider.

Jenis:	Int32
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:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

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

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

-Path

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

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

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

-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 nilai properti EnhancedKeyUsageList , gunakan parameter SSLServerAuthentication .

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	String[]
Position:	Named
Nilai default:	No alternate file streams
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

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.

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 di sesi Anda, ketik Get-PsProvider. Untuk informasi selengkapnya, lihat about_Providers.

Link Terkait

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider
• about_Providers