Bagikan melalui

Get-ItemProperty

  • Referensi
Modul:
Microsoft.PowerShell.Management

Mendapatkan properti item tertentu.

Sintaks

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Deskripsi

Get-ItemProperty Cmdlet mendapatkan properti item yang ditentukan. Misalnya, Anda dapat menggunakan cmdlet ini untuk mendapatkan nilai properti LastAccessTime dari objek file. Anda juga dapat menggunakan cmdlet ini untuk melihat entri registri dan nilainya.

Contoh

Contoh 1: Mendapatkan informasi tentang direktori tertentu

Perintah ini mendapatkan informasi tentang C:\Windows direktori.

Get-ItemProperty C:\Windows

Contoh 2: Mendapatkan properti file tertentu

Perintah ini mendapatkan properti C:\Test\Weather.xls file. Hasilnya disalurkan ke Format-List cmdlet untuk menampilkan output sebagai daftar.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Contoh 3: Dapatkan nama nilai dan data entri registri di subkunjuk registri

Perintah ini mendapatkan nama nilai dan data ProgramFilesDir entri registri di CurrentVersion subkuntah registri. Jalur menentukan subkunjuk dan parameter Nama menentukan nama nilai entri.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Catatan

Perintah ini mengharuskan ada drive PowerShell bernama HKLM: yang dipetakan ke HKEY_LOCAL_MACHINE sarang registri.

Drive dengan nama dan pemetaan tersebut tersedia di PowerShell secara default. Atau, jalur ke subkunjuk registri ini dapat ditentukan dengan menggunakan jalur alternatif berikut yang dimulai dengan nama penyedia diikuti oleh dua titik dua:

Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

Contoh 4: Mendapatkan nama nilai dan data entri registri dalam kunci registri

Perintah ini mendapatkan nama nilai dan data entri registri dalam PowerShellEngine kunci registri. Hasilnya ditunjukkan dalam contoh output berikut.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

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.

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

-Filter

Menentukan filter untuk memenuhi syarat parameter Jalur . Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung penggunaan filter. Anda dapat menemukan sintaks untuk bahasa filter FileSystem dalam about_Wildcards. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya ketika cmdlet mendapatkan objek daripada memfilter PowerShell objek setelah diambil.

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

-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

-Name

Menentukan nama properti atau properti yang akan diambil. Karakter kartubebas diizinkan.

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

-Path

Menentukan jalur ke item atau item. Karakter kartubebas diizinkan.

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

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

Boolean

String

DateTime

FileInfo

DirectoryInfo

Cmdlet ini mengembalikan objek untuk setiap properti item yang didapatkannya. Jenis objek tergantung pada objek yang diambil. Misalnya, dalam drive sistem file, mungkin mengembalikan file atau folder.

Catatan

PowerShell menyertakan alias berikut untuk Get-ItemProperty:

  • Semua platform:
    • gp

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