Get-Item
Öğeyi belirtilen konumda alır.
Syntax
Path (Default) - FileSystem provider
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath - FileSystem provider
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Path (Default) - Certificate provider
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[-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>]
[-UseTransaction]
[-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>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath - All providers
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Get-Item cmdlet'i, belirtilen konumdaki öğeyi getirir. Joker karakter (*) kullanılarak öğenin tüm içeriği istenmediği sürece, belirtilen konumdaki öğenin içeriği alınmaz.
Bu cmdlet, PowerShell sağlayıcıları tarafından farklı veri deposu türleri arasında gezinmek için kullanılır. Bazı parametreler yalnızca belirli bir sağlayıcı için kullanılabilir. Daha fazla bilgi için bkz. about_Providers.
Örnekler
Örnek 1: Geçerli dizini alma
Bu örnek geçerli dizini alır. Nokta ('.'), öğeyi geçerli konumda (içeriğinde değil) temsil eder.
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Örnek 2: Geçerli dizindeki tüm öğeleri alma
Bu örnek geçerli dizindeki tüm öğeleri alır. Joker karakter (*), geçerli öğenin tüm içeriğini temsil eder.
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
Örnek 3: Bir sürücünün geçerli dizinini alma
Bu örnek, C: sürücüsünün geçerli dizinini alır. Alınan nesne, içeriğini değil yalnızca dizini temsil eder.
Get-Item C:
Örnek 4: Belirtilen sürücüdeki öğeleri alma
Bu örnek, C: sürücüsündeki öğeleri alır. Joker karakter (*) yalnızca kapsayıcıyı değil kapsayıcıdaki tüm öğeleri temsil eder.
Get-Item C:\*
PowerShell'de, içeriği almak için geleneksel *yerine tek bir yıldız işareti (*.*) kullanın. Biçim tam anlamıyla yorumlanır, bu nedenle *.* nokta olmadan dizinleri veya dosya adlarını alamaz.
Örnek 5: Belirtilen dizindeki özelliği edin
Bu örnek, dizininin C:\Windows özelliğini alır.
LastAccessTime, dosya sistemi dizinlerinin yalnızca bir özelliğidir. Dizinin tüm özelliklerini görmek için (Get-Item <directory-name>) | Get-Memberyazın.
(Get-Item C:\Windows).LastAccessTime
Örnek 6: Kayıt defteri anahtarının içeriğini gösterme
Bu örnekte Microsoft.PowerShell kayıt defteri anahtarının içeriği gösterilmektedir. Kayıt defteri anahtarlarını ve alt anahtarları almak için bu cmdlet'i PowerShell Kayıt Defteri sağlayıcısıyla kullanabilirsiniz, ancak kayıt defteri değerlerini ve verilerini almak için Get-ItemProperty cmdlet'ini kullanmanız gerekir.
Get-Item HKLM:\Software\Microsoft\PowerShell\1\Shellids\Microsoft.PowerShell\
Örnek 7: Dizinde dışlama içeren öğeleri alma
Bu örnek, Windows dizininde nokta (.) içeren ancak w*ile başlamamış adlara sahip öğeleri alır. Bu örnek yalnızca yol, öğenin içeriğini belirtmek için bir joker karakter (*) içerdiğinde çalışır.
Get-Item C:\Windows\*.* -Exclude "w*"
Parametreler
-CodeSigningCert
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Code Signing özellik değerinde olan sertifikaları almak için CodeSigningCert parametresini kullanın.
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Uyarı
Bu parametre, PowerShell ile yüklenen sağlayıcılar 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.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DnsName
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Cmdlet'in aldığı sertifikaların DNSNameList özelliğiyle eşleşecek bir etki alanı adı veya ad deseni belirtir. Bu parametrenin değeri Unicode veya ASCIIolabilir. Punycode değerleri Unicode'a dönüştürülür. Joker karakterlere (*) izin verilir.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | DnsNameRepresentation |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DocumentEncryptionCert
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Document Encryption özellik değerinde olan sertifikaları almak için DocumentEncryptionCert parametresini kullanın.
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Eku
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Cmdlet'in aldığı sertifikaların EnhancedKeyUsageList özelliğiyle eşleşecek metni veya metin desenini belirtir. Joker karakterlere (*) izin verilir.
EnhancedKeyUsageList özelliği, EKU'nun kolay adını ve OID alanlarını içerir.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Exclude
Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txtgibi 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ExpiringInDays
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Cmdlet'in yalnızca belirtilen sayıda gün içinde veya daha önce süresi dolan sertifikaları döndürmesi gerektiğini belirtir. Sıfır (0) değeri süresi dolmuş sertifikaları alır.
Bu parametre PowerShell 7.1'de yeniden tanıtıldı
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Filter
Path parametresini nitelemek için bir filtre belirtir.
FileSystem sağlayıcısı, filtreleri destekleyen tek yüklü PowerShell sağlayıcısıdır. Filtreler diğer parametrelerden daha verimlidir. Sağlayıcı, cmdlet nesneleri alırken nesneleri filtreler, böylece PowerShell nesneleri aldıktan sonra filtreleme yapmaz. Filtre dizesi dosyaları listelemek için .NET API'sine geçirilir. API yalnızca * ve ? joker karakterlerini destekler.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Bu cmdlet'in gizli öğeler gibi başka türlü erişilmeyecek öğeleri aldığını gösterir. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz. about_Providers. cmdletForce parametresini kullanarak bile güvenlik kısıtlamalarını geçersiz kılamaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Include
Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txtgibi 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath |
Parametre kümeleri
LiteralPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Bir öğenin yolunu belirtir. Bu cmdlet öğeyi belirtilen konumda alır. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak parametre adı Yol isteğe bağlıdır.
Geçerli konumu belirtmek için nokta (.) kullanın. Geçerli konumdaki tüm öğeleri belirtmek için joker karakteri (*) kullanın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SSLServerAuthentication
Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Server Authentication özellik değerinde olan sertifikaları almak için SSLServerAuthentication parametresini kullanın.
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Stream
Bu, FileSystem sağlayıcısı tarafından sağlanan dinamik bir parametredir.
Belirtilen alternatif NTFS dosya akışını dosyadan alır. Akış adını girin. Joker karakterler desteklenmektedir. Tüm akışları almak için yıldız işareti (*) kullanın. Bu parametre klasörlerde geçerli değil.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Daha fazla bilgi için bkz. about_FileSystem_Provider.
Parametre özellikleri
| Tür: | String[] |
| Default value: | No alternate file streams |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UseTransaction
Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | usetx |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.
Çıkışlar
AliasInfo
Cmdlet, Alias: sürücüsüne erişirken bu türden bir çıktı üretir.
X509StoreLocation
X509Store
X509Certificate2
Cmdlet, Cert: sürücüsüne erişirken bu türlerin çıktısını verir.
DictionaryEntry
Cmdlet, Env: sürücüsüne erişirken bu türden bir çıktı üretir.
DirectoryInfo
FileInfo
Cmdlet, FileSystem sürücülerine erişirken bu türlerin çıkışını oluşturur.
FunctionInfo
FilterInfo
cmdlet, Function: sürücülerine erişirken bu türlerin çıktısını verir.
RegistryKey
Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür bir çıktı üretir.
PSVariable
cmdlet, Variable: sürücülerine erişirken bu tür çıkışlar yapar.
WSManConfigContainerElement
WSManConfigLeafElement
cmdlet, WSMan: sürücülerine erişirken bu türlerin çıktısını verir.
Notlar
Windows PowerShell, Get-Itemiçin aşağıdaki diğer adları içerir:
gi
Bu cmdlet'in Yineleme parametresi yoktur, çünkü yalnızca bir öğe alır, içeriği almaz.
Bir öğenin içeriğini özyinelemeli olarak almak için Get-ChildItemkullanın.
Kayıt defterinde gezinmek için bu cmdlet'i kullanarak kayıt defteri anahtarlarını alın ve Get-ItemProperty kullanarak kayıt defteri değerlerini ve verilerini alın. Kayıt defteri değerleri, kayıt defteri anahtarının özellikleri olarak kabul edilir.
Bu cmdlet, 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-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.
