Get-ItemProperty
Belirtilen öğenin özelliklerini alır.
Sözdizimi
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>]
Description
Get-ItemProperty
cmdlet'i belirtilen öğelerin özelliklerini alır. Örneğin, bir dosya nesnesinin LastAccessTime özelliğinin değerini almak için bu cmdlet'i kullanabilirsiniz. Kayıt defteri girdilerini ve değerlerini görüntülemek için bu cmdlet'i de kullanabilirsiniz.
Örnekler
Örnek 1: Belirli bir dizin hakkında bilgi alma
Bu komut C:\Windows
dizini hakkında bilgi alır.
Get-ItemProperty C:\Windows
Örnek 2: Belirli bir dosyanın özelliklerini alma
Bu komut C:\Test\Weather.xls
dosyasının özelliklerini alır. Sonuç, çıkışı liste olarak görüntülemek için Format-List
cmdlet'ine kanalize edilir.
Get-ItemProperty C:\Test\Weather.xls | Format-List
Örnek 3: Kayıt defteri alt anahtarındaki bir kayıt defteri girdisinin değer adını ve verilerini alma
Bu komut, CurrentVersion
kayıt defteri alt anahtarındaki ProgramFilesDir
kayıt defteri girdisinin değer adını ve verilerini alır.
Yolu alt anahtarı ve Adı parametresi girdinin değer adını belirtir.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Not
Bu komut, kayıt defterinin HKEY_LOCAL_MACHINE
kovanına eşlenen HKLM:
adlı bir PowerShell sürücüsü olmasını gerektirir.
Bu ada ve eşlemeye sahip bir sürücü varsayılan olarak PowerShell'de kullanılabilir. Alternatif olarak, bu kayıt defteri alt anahtarının yolu, sağlayıcı adı ve ardından iki iki nokta üst üste ile başlayan aşağıdaki alternatif yol kullanılarak belirtilebilir:
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion
.
Örnek 4: Kayıt defteri anahtarındaki kayıt defteri girdilerinin değer adlarını ve verilerini alma
Bu komut, PowerShellEngine
kayıt defteri anahtarındaki kayıt defteri girdilerinin değer adlarını ve verilerini alır. Sonuçlar aşağıdaki örnek çıktıda gösterilmiştir.
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
Parametreler
-Credential
Not
Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.
Tür: | PSCredential |
Position: | Named |
Default value: | Current user |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Exclude
Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txt
gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Exclude parametresi, yalnızca komut C:\Windows\*
gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows
dizininin içeriğini belirtir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Filter
Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcardsbulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Include
Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txt
gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Include parametresi, yalnızca komut C:\Windows\*
gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows
dizininin içeriğini belirttiğinde etkilidir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-LiteralPath
Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Tür: | String[] |
Diğer adlar: | PSPath, LP |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Name
Alınacak özelliğin veya özelliklerin adını belirtir. Joker karakterlere izin verilir.
Tür: | String[] |
Diğer adlar: | PSProperty |
Position: | 1 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Path
Öğenin veya öğelerin yolunu belirtir. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
Girişler
Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.
Çıkışlar
Bu cmdlet, aldığı her öğe özelliği için bir nesne döndürür. Nesne türü, alınan nesneye bağlıdır. Örneğin, bir dosya sistemi sürücüsünde bir dosya veya klasör döndürebilir.
Notlar
PowerShell, Get-ItemProperty
için aşağıdaki diğer adları içerir:
- Tüm platformlar:
gp
Get-ItemProperty
cmdlet'i herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvider
yazın. Daha fazla bilgi için bkz. about_Providers.