Get-ItemPropertyValue

Mendapatkan nilai untuk satu atau beberapa properti item tertentu.

Sintaks

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

Deskripsi

Get-ItemPropertyValue mendapatkan nilai saat ini untuk properti yang Anda tentukan saat menggunakan parameter Nama, yang terletak di jalur yang Anda tentukan dengan parameter Jalur atau LiteralPath.

Contoh

Contoh 1: Dapatkan nilai properti ProductID

Perintah ini mendapatkan nilai properti ProductID objek \SOFTWARE\Microsoft\WindowsNT\CurrentVersion di penyedia Windows Registry.

Get-ItemPropertyValue 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name ProductID

94253-50000-11141-AA785

Contoh 2: Dapatkan waktu tulis terakhir file atau folder

Perintah ini mendapatkan nilai properti LastWriteTime , atau terakhir kali file atau folder diubah, dari C:\Program Files\WindowsPowerShell folder, bekerja di penyedia FileSystem.

Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime

Wednesday, September 3, 2014 2:53:22 PM

Contoh 3: Mendapatkan beberapa nilai properti file atau folder

Perintah ini mendapatkan nilai properti LastWriteTime, CreationTime, dan Root folder. Nilai properti dikembalikan dalam urutan anda menentukan nama properti.

Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime,CreationTime,Root

Tuesday, March 23, 2021 6:53:13 AM
Monday, August 14, 2017 1:42:40 PM

Name              : C:\
FullName          : C:\
Parent            :
Exists            : True
Root              : C:\
Extension         :
CreationTime      : 10/30/2015 1:28:30 AM
CreationTimeUtc   : 10/30/2015 6:28:30 AM
LastAccessTime    : 5/26/2021 9:24:31 AM
LastAccessTimeUtc : 5/26/2021 2:24:31 PM
LastWriteTime     : 5/25/2021 7:25:08 AM
LastWriteTimeUtc  : 5/25/2021 12:25:08 PM
Attributes        : Hidden, System, Directory
Mode              : d--hs-
BaseName          : C:\
Target            : {}
LinkType          :

Parameter

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini.

Ketik nama pengguna, seperti "User01" atau "Domain01\User01", atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential cmdlet. Jika Anda mengetik nama pengguna, Anda akan dimintai kata sandi.

Peringatan

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan Windows PowerShell.

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

-Exclude

Menentukan, sebagai array string, item atau item yang dikecualikan cmdlet ini dari operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan.

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

-Filter

Menentukan filter dalam format atau bahasa penyedia. Nilai parameter ini memenuhi syarat parameter Path .

Sintaks filter, termasuk penggunaan karakter kartubebas, tergantung pada penyedia. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya ketika cmdlet mendapatkan objek daripada memfilter PowerShell objek setelah diambil.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-LiteralPath

Menentukan jalur ke lokasi properti saat ini. Tidak seperti parameter Jalur, 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.

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

-Name

Menentukan nama properti atau properti yang akan diambil.

Type:String[]
Aliases:PSProperty
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menentukan jalur ke item atau item.

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

-UseTransaction

Menyertakan perintah dalam transaksi aktif. Parameter ini hanya valid ketika transaksi sedang berlangsung. Untuk informasi selengkapnya, lihat about_Transactions.

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

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

PSObject

Cmdlet ini mengembalikan objek untuk setiap nilai properti item yang didapatkannya. Jenis objek tergantung pada nilai properti yang diambil.

Catatan

Windows PowerShell menyertakan alias berikut untuk Get-ItemPropertyValue:

  • gpv

Cmdlet ini dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, jalankan Get-PSProvider cmdlet. Untuk informasi selengkapnya, lihat about_Providers.