Aracılığıyla paylaş

Get-Item

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Öğeyi belirtilen konumda alır.

Sözdizimi

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

Description

Get-Item Cmdlet, öğeyi belirtilen konumda alır. Öğenin tüm içeriğini istemek için joker karakter (*) kullanmadığınız sürece öğenin içeriğini konumda almaz.

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, sürücünün geçerli dizinini C: 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, sürücüdeki C: öğ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ı alamazsınız.

Örnek 5: Belirtilen dizinde bir özellik alma

Bu örnek dizinin LastAccessTime özelliğini C:\Windows alır. LastAccessTime , dosya sistemi dizinlerinin yalnızca bir özelliğidir. Dizinin tüm özelliklerini görmek için yazın (Get-Item <directory-name>) | Get-Member.

(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. Bu cmdlet'i PowerShell Kayıt Defteri sağlayıcısıyla birlikte kullanarak kayıt defteri anahtarlarını ve alt anahtarları alabilirsiniz, ancak kayıt defteri değerlerini ve verilerini almak için cmdlet'ini kullanmanız Get-ItemProperty 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 ile w*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.

EnhancedKeyUsageList özellik değerindeki Code Signing sertifikaları almak için CodeSigningCert parametresini kullanın.

Daha fazla bilgi için bkz . about_Certificate_Provider.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

Not

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-Command kullanın.

Tür:PSCredential
Position:Named
Default value:Current user
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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 veya ASCIIolabilirUnicode. 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.

Tür:DnsNameRepresentation
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-DocumentEncryptionCert

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.

EnhancedKeyUsageList özellik değerine sahip Document Encryption sertifikaları almak için DocumentEncryptionCert parametresini kullanın.

Daha fazla bilgi için bkz . about_Certificate_Provider.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

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

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 aldıktan sonra PowerShell'in nesneleri filtrelemesini yapmak yerine nesneleri aldığında filtre uygular. Filtre dizesi dosyaları listelemek için .NET API'sine geçirilir. API yalnızca ve ? joker karakterlerini destekler*.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-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. Zorla parametresi kullanıldığında bile cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

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
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Path

Bir öğenin yolunu belirtir. Bu cmdlet öğeyi belirtilen konumda alır. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak Path parametre adı 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.

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-SSLServerAuthentication

Bu, Sertifika sağlayıcısı tarafından sağlanan dinamik bir parametredir.

EnhancedKeyUsageList özellik değerindeki Server Authentication sertifikaları almak için SSLServerAuthentication parametresini kullanın.

Daha fazla bilgi için bkz . about_Certificate_Provider.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 desteklenir. 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.

Tür:String[]
Position:Named
Default value:No alternate file streams
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

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

Tür:SwitchParameter
Diğer adlar:usetx
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

AliasInfo

Cmdlet, sürücüye erişirken bu tür çıkışlar Alias: oluşturur.

X509StoreLocation

X509Store

X509Certificate2

Cmdlet, sürücüye erişirken bu türlerin çıkışını Cert: oluşturur.

DictionaryEntry

Cmdlet, sürücüye erişirken bu tür çıkışlar Env: oluşturur.

DirectoryInfo

FileInfo

Cmdlet, Dosya Sistemi sürücülerine erişirken bu türlerin çıkışını oluşturur.

FunctionInfo

FilterInfo

Cmdlet, sürücülere erişirken bu türlerin çıkışını Function: oluşturur.

RegistryKey

Cmdlet, Kayıt Defteri sürücülerine erişirken bu tür bir çıkış oluşturur.

PSVariable

Cmdlet, sürücülere erişirken Variable: bu tür çıkış yapar.

WSManConfigContainerElement

WSManConfigLeafElement

Cmdlet, sürücülere erişirken bu türlerin çıkışını WSMan: oluşturur.

Notlar

Windows PowerShell için aşağıdaki diğer adları Get-Itemiçerir:

  • gi

Bu cmdlet'in özyineleme parametresi yok, çünkü içeriği değil yalnızca bir öğe alıyor. Bir öğenin içeriğini özyinelemeli olarak almak için kullanın Get-ChildItem.

Kayıt defterinde gezinmek için bu cmdlet'i kullanarak kayıt defteri anahtarlarını alın ve Get-ItemProperty 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 yazın Get-PsProvider. Daha fazla bilgi için bkz . about_Providers.